Skip to content
Back to skills

Gsap Refactor

ASecurity

Orchestrate safe GSAP improvements for existing pages or components. Use when the page already exists and needs better animation quality, cleanup, performance fixes, accessibility hardening, or a more coherent motion system. Read current code and .gsap artifacts first, audit the current motion system, build a refactor plan, apply safe improvements, then update artifacts.

  • 6 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added November 13, 2026
ai-agentspythongobashperformance

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned November 13, 2026

npx -y skills add m3taz-ahmed/aizee --skill gsap-refactor --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Gsap Refactor?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Gsap Refactor
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/m3taz-ahmed-gsap-refactor/badge)](https://www.skillsdirectory.com/skills/m3taz-ahmed-gsap-refactor)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: gsap-refactor
description: Orchestrate safe GSAP improvements for existing pages or components. Use when the page already exists and needs better animation quality, cleanup, performance fixes, accessibility hardening, or a more coherent motion system. Read current code and .gsap artifacts first, audit the current motion system, build a refactor plan, apply safe improvements, then update artifacts.
---

# GSAP Refactor

Use this workflow for existing pages/components that already have code and may already have motion.

## Sequence

1. Read `.gsap` artifacts first.
2. Read the actual implementation files.
3. Run internal discovery, audit, and scan helpers.
4. Detect framework, packages, routes, current motion libraries, and matched page files.
5. Identify what to preserve, remove, simplify, or improve.
6. Update `.gsap/audit-report.md`, `.gsap/animation-plan.md`, `.gsap/tasks/<page>.tasks.md`, and `.gsap/phases/<page>/*.md`.
7. Split the refactor into phased sections instead of sweeping the full page at once.
8. Apply safe changes to the active phase only unless the user asks for a broader pass.
9. Update page artifact statuses and notes.

## Internal Helper

Use:

```bash
python scripts/gsap_workflow.py gsap-refactor --path "<project>" --page "<page>"
```

This command should gather current workflow state, inspect the project structure, detect current motion systems, write audit/refactor notes, and prepare implementation state. It is the only public helper command for this mode.

## Refactor Rules

- preserve good motion when possible
- remove noisy or redundant effects
- add reduced-motion handling where missing
- reduce mobile-heavy patterns before adding more spectacle
- do not change the motion direction without updating `.gsap` artifacts

## Completion

Before finishing, ensure:

- `.gsap/audit-report.md` records major findings and fixes
- `.gsap/animation-plan.md` reflects the refactor priorities
- `.gsap/tasks/<page>.tasks.md` reflects the current queue and active phase
- `.gsap/phases/<page>/` reflects the refactor section breakdown
- `.gsap/pages/<page>.animation.md` reflects the final status

Files in this skill

  • SKILL.md2.1 KB
  • agents/openai.yaml293 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.