@skilly-hand/skilly-hand 0.28.0 → 0.29.1

package/CHANGELOG.md

@@ -16,6 +16,36 @@ All notable changes to this project are documented in this file.
 ### Removed
 - _None._
 
+## [0.29.1] - 2026-05-23
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.1)
+
+### Added
+- Added `context-handoff` for compact, privacy-aware session handoffs across agent chats.
+
+### Changed
+- _None._
+
+### Fixed
+- _None._
+
+### Removed
+- _None._
+
+## [0.29.0] - 2026-05-23
+[View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.29.0)
+
+### Added
+- Added `forge-me-a-skill` as the portable catalog workflow for creating and standardizing reusable skills.
+
+### Changed
+- Expanded `gsap-animation` guidance with utilities, Vue/Svelte/Nuxt framework patterns, and official GSAP plugin coverage.
+
+### Fixed
+- _None._
+
+### Removed
+- Removed the old `skill-creator` catalog ID in favor of `forge-me-a-skill`.
+
 ## [0.28.0] - 2026-05-16
 [View on npm](https://www.npmjs.com/package/@skilly-hand/skilly-hand/v/0.28.0)
 

package/README.md

@@ -86,6 +86,7 @@ The catalog currently includes:
 - `agents-root-orchestrator`
 - `angular-guidelines`
 - `figma-mcp-0to1`
+- `forge-me-a-skill`
 - `frontend-design`
 - `gsap-animation`
 - `motion-animation`
@@ -96,7 +97,6 @@ The catalog currently includes:
 - `react-guidelines`
 - `review-rangers`
 - `roaster`
-- `skill-creator`
 - `spec-driven-development`
 - `test-driven-development`
 - `token-optimizer`

package/catalog/README.md

@@ -7,9 +7,11 @@ Published portable skills consumed by the `skilly-hand` CLI.
 | `accessibility-audit` | Audit web accessibility against W3C WCAG 2.2 Level AA using framework-agnostic checks, remediation patterns, and portable command-line scanning. | frontend, accessibility, workflow, quality | all |
 | `agents-root-orchestrator` | Author root AGENTS.md as a Where/What/When orchestrator that routes tasks and skill invocation clearly. | core, workflow, orchestration | all |
 | `angular-guidelines` | Guide Angular code generation, review, and performance tuning using latest stable Angular verification, official Angular skill guidance, and modern framework best practices. Trigger: generating, reviewing, refactoring, or optimizing Angular code artifacts in Angular projects. | angular, frontend, workflow, best-practices | all |
+| `context-handoff` | Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats. | core, workflow, memory, communication | all |
 | `figma-mcp-0to1` | Guide users from Figma MCP installation and authentication through first canvas creation, with function-level tool coverage and operational recovery patterns. | figma, mcp, workflow, design | all |
+| `forge-me-a-skill` | Create and standardize AI skills with reusable structure, metadata rules, and templates. | core, workflow, authoring | all |
 | `frontend-design` | Project-aware frontend design skill that detects the existing tech stack, UI libraries, CSS variables, and design tokens before proposing any UI work. Supports greenfield projects via DESIGN.md context setup, taste-reference extraction, post-generation critique, visual refinement, and Motion/GSAP-aware motion polish. | frontend, design, workflow, ui, motion, greenfield | all |
-| `gsap-animation` | Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, JavaScript animation libraries, or advanced UI animation. | frontend, animation, motion, gsap, workflow | all |
+| `gsap-animation` | Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, gsap.utils, Vue/Svelte/Nuxt animation, GSAP plugins, JavaScript animation libraries, or advanced UI animation. | frontend, animation, motion, gsap, workflow | all |
 | `motion-animation` | Guide Motion, formerly Framer Motion, animation implementation using only official Motion documentation. Trigger: implementing, reviewing, or choosing Motion for JavaScript animation, React motion components, gestures, scroll animation, layout animation, exit animation, or framework-agnostic UI motion. | frontend, animation, motion, framer-motion, workflow | all |
 | `output-optimizer` | Optimize output token consumption through compact interpreter modes with controlled expansion when complexity, ambiguity, or risk requires more detail. Trigger: minimizing response verbosity while preserving clarity and correctness. | core, workflow, efficiency, communication | all |
 | `project-security` | Scan project configuration and release surfaces for leak and security risks, and enforce security gates on commit, push, and publish workflows across GitHub, GitLab, npm, pnpm, yarn, and generic CI. Trigger: validating repository security posture, preventing secret leaks, or hardening delivery pipelines. | security, workflow, quality, core | all |
@@ -18,7 +20,6 @@ Published portable skills consumed by the `skilly-hand` CLI.
 | `react-guidelines` | Guide React and Next.js code generation, review, and performance tuning using latest stable React verification and modern framework best practices. Trigger: generating, reviewing, refactoring, or optimizing React code artifacts in React projects. | react, frontend, workflow, best-practices | all |
 | `review-rangers` | Review code, decisions, and artifacts through a multi-perspective committee and a domain expert safety guard, then synthesize a structured verdict. | core, workflow, review, quality | all |
 | `roaster` | Challenge plans with constructive roast-style critique that exposes weak assumptions, missing angles, shallow sequencing, and unclear success criteria. Trigger: when the user proposes, requests, or evaluates a plan of any kind. | core, workflow, planning, quality | all |
-| `skill-creator` | Create and standardize AI skills with reusable structure, metadata rules, and templates. | core, workflow, authoring | all |
 | `spec-driven-development` | Plan, execute, and verify multi-step work through versioned specs with small, testable tasks. | core, workflow, planning | all |
 | `test-driven-development` | Guide implementation using the RED → GREEN → REFACTOR TDD cycle: write a failing test first, write the minimum code to pass, then refactor while tests stay green. | testing, workflow, quality, core | all |
 | `token-optimizer` | Classify task complexity and right-size reasoning depth, context gathering, and response detail to reduce wasted tokens. | core, workflow, efficiency | all |

package/catalog/skills/agents-root-orchestrator/SKILL.md

@@ -112,7 +112,7 @@ Are trigger conditions currently implicit or ambiguous?
 | Action | Skill |
 | ------ | ----- |
 | Planning multi-step feature work | `spec-driven-development` |
-| Creating new reusable skill instructions | `skill-creator` |
+| Creating new reusable skill instructions | `forge-me-a-skill` |
 | Updating root AGENTS orchestration map | `agents-root-orchestrator` |
 ```
 
@@ -127,7 +127,7 @@ Chaining notations document integrated workflows where multiple skills are seque
 
 ```text
 Asking for a new skill
-  -> skill-creator
+  -> forge-me-a-skill
   -> spec-driven-development
   -> agents-root-orchestrator
 ```
@@ -151,5 +151,5 @@ npx skilly-hand install --dry-run
 
 - Template: [assets/AGENTS-ROOT-TEMPLATE.md](assets/AGENTS-ROOT-TEMPLATE.md)
 - Companion skills:
-  - [../skill-creator/SKILL.md](../skill-creator/SKILL.md)
+  - [../forge-me-a-skill/SKILL.md](../forge-me-a-skill/SKILL.md)
   - [../spec-driven-development/SKILL.md](../spec-driven-development/SKILL.md)

package/catalog/skills/agents-root-orchestrator/assets/AGENTS-ROOT-TEMPLATE.md

@@ -24,7 +24,7 @@
 | Task Type | Recommended Skill Chain |
 | --------- | ----------------------- |
 | Multi-step planning | `spec-driven-development` |
-| Creating/updating reusable skills | `skill-creator` |
+| Creating/updating reusable skills | `forge-me-a-skill` |
 | Root AGENTS orchestration updates | `agents-root-orchestrator` |
 
 ## When
@@ -50,7 +50,7 @@ Chaining notations document integrated workflows where multiple skills are seque
 ```text
 Updating root AGENTS orchestration guidance
   -> agents-root-orchestrator
-  -> skill-creator (if workflow guidance changes)
+  -> forge-me-a-skill (if workflow guidance changes)
 ```
 
 When to use: maintaining repository-level routing, trigger, and escalation guidance.
@@ -59,7 +59,7 @@ When to use: maintaining repository-level routing, trigger, and escalation guida
 
 ```text
 Asking for a new reusable skill
-  -> skill-creator
+  -> forge-me-a-skill
   -> spec-driven-development
   -> agents-root-orchestrator
 ```

package/catalog/skills/context-handoff/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: "context-handoff"
+description: "Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats."
+skillMetadata:
+  author: "skilly-hand"
+  last-edit: "2026-05-23"
+  license: "Apache-2.0"
+  version: "1.0.0"
+  changelog: "Added context-handoff skill for project-local session continuity; preserves compact verified context across chats without transcript bloat; affects catalog skill routing and handoff-writing workflows"
+  auto-invoke: "Summarizing, compacting, preserving, or handing off session context across chats"
+  allowed-tools:
+    - "Read"
+    - "Edit"
+    - "Write"
+    - "Glob"
+    - "Grep"
+    - "Bash"
+    - "Task"
+---
+# Context Handoff Guide
+
+## When to Use
+
+Use this skill when:
+
+- A user asks to summarize, compact, preserve, or hand off session context.
+- Work may continue in a later chat, agent session, branch, or review.
+- Important decisions, current state, artifacts, unresolved questions, or next actions would otherwise be lost.
+- A project needs a concise `.context/` Markdown handoff that is readable by humans and useful to future AI agents.
+
+Do not use this skill for:
+
+- Full transcript archiving by default.
+- Personal journaling, private memory claims, or speculative profile building.
+- Critiquing the session, evaluating the user, or adding opinions not requested.
+- Replacing formal specs, issue trackers, changelogs, ADRs, or release notes when those are the better source of truth.
+
+---
+
+## Critical Patterns
+
+### Pattern 1: Store Project-Local Context
+
+Write handoff files under `.context/` in the active project root.
+
+Use this filename format:
+
+```text
+.context/YYYY-MM-DDTHHMMSSZ-context-handoff-<slug>.md
+```
+
+The folder is for project-local context handoffs. It is not personal memory, hidden long-term recall, or a place to dump raw chat history.
+
+### Pattern 2: Capture Verified Context Only
+
+Write as a professional transcriber and technical handoff writer:
+
+- Preserve facts from the session, repository, commands, files, decisions, and user-provided constraints.
+- Mark uncertainty explicitly as `Unknown`, `Unresolved`, or `Assumption`.
+- Do not invent motivations, conclusions, files, tests, or status.
+- Do not critique the user, the plan, or the implementation unless the user explicitly requested critique and it belongs in the handoff.
+
+### Pattern 3: Prefer Compact Handoff Over Transcript
+
+Default to a concise, structured handoff that a future agent can scan quickly.
+
+Include:
+
+- Purpose and current state.
+- Key context and constraints.
+- Decisions made.
+- Artifacts touched or produced.
+- Open questions and blockers.
+- Next actions.
+- Verification status.
+- A resume prompt.
+
+Exclude:
+
+- Routine back-and-forth.
+- Long command logs unless the exact output is essential.
+- Sensitive data, secrets, credentials, tokens, or private personal details.
+- Repeated explanations already captured in a durable project artifact.
+
+### Pattern 4: Screen Before Writing
+
+Before creating or updating a `.context/` file:
+
+1. Check whether the handoff may include secrets, credentials, tokens, private personal data, or proprietary data the user did not ask to persist.
+2. Redact sensitive values and describe them generically.
+3. If the user explicitly asks to persist sensitive content, confirm before writing it.
+4. Keep the handoff scoped to what future work needs.
+
+---
+
+## Decision Tree
+
+```text
+User asks to preserve or resume session context?       -> Create `.context/` handoff
+User asks for exact transcript or quotes?              -> Ask whether full transcript is required
+Formal requirement/spec/change log is needed?          -> Route to the appropriate durable artifact
+Sensitive content would be persisted?                  -> Redact or confirm before writing
+Context is uncertain or inferred?                      -> Label as Unknown, Unresolved, or Assumption
+Otherwise                                             -> Write compact neutral handoff
+```
+
+---
+
+## Examples
+
+### Example 1: Handoff Request
+
+```text
+Request: "Summarize this session so we can continue tomorrow."
+Action: Create `.context/2026-05-23T184512Z-context-handoff-auth-refactor.md` with current state, decisions, artifacts, open questions, next actions, verification, and resume prompt.
+```
+
+### Example 2: Privacy-Safe Capture
+
+```text
+Request: "Save the deployment notes, including the token I pasted."
+Action: Redact the token, record that a deployment token was provided in-session, and confirm before persisting any exact secret value.
+```
+
+### Example 3: Not a Critique
+
+```text
+Request: "Make a handoff from this planning session."
+Action: Record agreed scope, assumptions, unresolved decisions, and next steps. Do not rate the plan or add unsolicited objections.
+```
+
+---
+
+## Commands
+
+```bash
+mkdir -p .context
+date -u +"%Y-%m-%dT%H%M%SZ"
+rg -n "TODO|FIXME|Assumption|Unresolved" .context
+```
+
+---
+
+## Resources
+
+- Handoff template: [assets/handoff-template.md](assets/handoff-template.md)
+- Related compact output skill: [../output-optimizer/SKILL.md](../output-optimizer/SKILL.md)
+- Related planning workflow: [../spec-driven-development/SKILL.md](../spec-driven-development/SKILL.md)

package/catalog/skills/context-handoff/assets/handoff-template.md

@@ -0,0 +1,54 @@
+# {Title}
+
+---
+id: "{YYYY-MM-DDTHHMMSSZ-context-handoff-slug}"
+title: "{Title}"
+created_at: "{YYYY-MM-DDTHHMMSSZ}"
+source: "{session | repo | review | implementation | planning}"
+status: "{draft | ready | superseded}"
+tags: ["context-handoff"]
+---
+
+## Purpose
+
+{Why this handoff exists and what future work it should enable.}
+
+## Current State
+
+{Verified state of the work, repo, artifacts, branch, tests, or decisions at the time of capture.}
+
+## Key Context
+
+- {Important fact, constraint, preference, or dependency.}
+- {Important fact, constraint, preference, or dependency.}
+
+## Decisions
+
+- {Decision made, with brief reason if known.}
+- {Decision made, with brief reason if known.}
+
+## Artifacts
+
+- `{path-or-url}`: {what it is and why it matters.}
+- `{path-or-url}`: {what it is and why it matters.}
+
+## Open Questions
+
+- {Unknown, unresolved point, or decision still needed.}
+- {Unknown, unresolved point, or decision still needed.}
+
+## Next Actions
+
+1. {Next concrete step.}
+2. {Next concrete step.}
+3. {Next concrete step.}
+
+## Verification
+
+{Checks run, checks not run, observed results, and remaining verification risk.}
+
+## Resume Prompt
+
+```text
+Continue from this handoff. First read this file, verify current repo state, then proceed with: {specific next objective}.
+```

package/catalog/skills/context-handoff/manifest.json

@@ -0,0 +1,33 @@
+{
+  "id": "context-handoff",
+  "title": "Context Handoff",
+  "description": "Capture compact, neutral, AI-ready Markdown handoffs that preserve session context across chats without becoming a full transcript or personal memory store. Trigger: summarizing, compacting, preserving, or handing off session context across chats.",
+  "portable": true,
+  "tags": ["core", "workflow", "memory", "communication"],
+  "detectors": ["always"],
+  "detectionTriggers": ["always"],
+  "installsFor": ["all"],
+  "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
+  "skillMetadata": {
+    "author": "skilly-hand",
+    "last-edit": "2026-05-23",
+    "license": "Apache-2.0",
+    "version": "1.0.0",
+    "changelog": "Added context-handoff skill for project-local session continuity; preserves compact verified context across chats without transcript bloat; affects catalog skill routing and handoff-writing workflows",
+    "auto-invoke": "Summarizing, compacting, preserving, or handing off session context across chats",
+    "allowed-tools": [
+      "Read",
+      "Edit",
+      "Write",
+      "Glob",
+      "Grep",
+      "Bash",
+      "Task"
+    ]
+  },
+  "files": [
+    { "path": "SKILL.md", "kind": "instruction" },
+    { "path": "assets/handoff-template.md", "kind": "asset" }
+  ],
+  "dependencies": []
+}

package/catalog/skills/{skill-creator → forge-me-a-skill}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "skill-creator"
+name: "forge-me-a-skill"
 description: "Create and standardize AI skills with reusable structure, metadata rules, and templates."
 skillMetadata:
   author: "skilly-hand"
@@ -20,7 +20,7 @@ skillMetadata:
     - "Task"
     - "SubAgent"
 ---
-# Skill Creator Guide
+# Forge Me A Skill Guide
 
 ## When to Create a Skill
 
@@ -52,6 +52,8 @@ skills/{skill-name}/
 │   │   └── SKILL.md
 │   └── agent2/
 │       └── SKILL.md
+├── scripts/              # Optional - executable helpers for repeatable tasks
+│   └── helper.sh
 └── references/           # Optional - links to local docs
     └── docs.md
 ```
@@ -65,16 +67,17 @@ skills/{skill-name}/
 | Generic skill | `{technology}` | `pytest`, `playwright`, `typescript` |
 | `{product-name}`-specific | `{product-name}-{purpose}` | `{product-name}-best-practices`, `{product-name}-code-connect`, `{product-name}-a11y-checker` |
 | `{product-name}` testing | `{product-name}-{function}-{target}` | `{product-name}-unit-test`, `{product-name}-token-audit` |
-| Workflow skill | `{action}-{target}` | `skill-creator`, `commit-writer`, `pr-writer` |
+| Workflow skill | `{action}-{target}` | `forge-me-a-skill`, `commit-writer`, `pr-writer` |
 
 ---
 
-## Decision: assets/ vs references/ vs agents/
+## Decision: assets/ vs scripts/ vs references/ vs agents/
 
 ```text
 Need code templates?        -> assets/
 Need JSON schemas?          -> assets/
 Need example configs?       -> assets/
+Need executable helpers?    -> scripts/
 Link to existing docs?      -> references/
 Link to external guides?    -> references/ (with local path)
 Skill needs sub-agents?     -> agents/

package/catalog/skills/{skill-creator → forge-me-a-skill}/manifest.json

@@ -1,6 +1,6 @@
 {
-  "id": "skill-creator",
-  "title": "Skill Creator",
+  "id": "forge-me-a-skill",
+  "title": "Forge Me A Skill",
   "description": "Create and standardize AI skills with reusable structure, metadata rules, and templates.",
   "portable": true,
   "tags": ["core", "workflow", "authoring"],

package/catalog/skills/gsap-animation/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: "gsap-animation"
-description: "Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, JavaScript animation libraries, or advanced UI animation."
+description: "Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, gsap.utils, Vue/Svelte/Nuxt animation, GSAP plugins, JavaScript animation libraries, or advanced UI animation."
 skillMetadata:
   author: "skilly-hand"
-  last-edit: "2026-05-03"
+  last-edit: "2026-05-23"
   license: "Apache-2.0"
-  version: "1.0.0"
-  changelog: "Added aggregate GSAP animation guidance backed by official GSAP docs and official GSAP AI skills; improves frontend motion implementation with verified timelines, ScrollTrigger, React cleanup, plugin, performance, and accessibility patterns; affects frontend animation routing and catalog discovery"
-  auto-invoke: "Implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, JavaScript animation libraries, or advanced UI animation"
+  version: "1.1.0"
+  changelog: "Expanded GSAP catalog guidance with utilities, non-React framework patterns, official plugin availability, and upstream skill routing; improves official-source coverage and trigger precision; affects GSAP animation skill routing, catalog discovery, and implementation references"
+  auto-invoke: "Implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, gsap.utils, Vue/Svelte/Nuxt animation, GSAP plugins, JavaScript animation libraries, or advanced UI animation"
   allowed-tools:
     - "Read"
     - "Edit"
@@ -26,7 +26,7 @@ skillMetadata:
 
 Use this skill when:
 
-- The user asks for GSAP, GreenSock, JavaScript animation, advanced frontend motion, timelines, scroll-driven animation, pinning, parallax, ScrollTrigger, or React `useGSAP()`.
+- The user asks for GSAP, GreenSock, JavaScript animation, advanced frontend motion, timelines, scroll-driven animation, pinning, parallax, ScrollTrigger, React `useGSAP()`, `gsap.utils`, Vue, Svelte, Nuxt, or GSAP plugins.
 - Another skill needs a verified GSAP handoff for richer UI motion than CSS transitions can comfortably express.
 - A project needs animation that is sequenced, reversible, controllable at runtime, scroll-linked, SVG-heavy, or framework-agnostic.
 
@@ -46,7 +46,7 @@ Use only:
 
 - GSAP docs at `https://gsap.com/docs/v3/`.
 - GSAP learning/resources pages linked from the official docs.
-- The official `greensock/gsap-skills` repository linked from the GSAP docs.
+- The official `greensock/gsap-skills` repository linked from the GSAP docs, including its focused AI skill files.
 
 Do not use blog posts, snippets, Stack Overflow answers, social posts, or memory-only claims as source material for GSAP API behavior. If a detail is not covered by the reference files, check official docs before using it.
 
@@ -60,7 +60,9 @@ Do not use blog posts, snippets, Stack Overflow answers, social posts, or memory
 | Multi-step sequencing or runtime control | GSAP timeline guidance in [references/core-patterns.md](references/core-patterns.md) |
 | Scroll reveals, scrub, pin, snap, parallax | [references/scrolltrigger-patterns.md](references/scrolltrigger-patterns.md) |
 | React or Next.js animation | [references/react-patterns.md](references/react-patterns.md) |
-| Flip, Draggable, SplitText, SVG, ScrollSmoother, utility plugins | [references/plugin-selection.md](references/plugin-selection.md) |
+| Vue, Nuxt, Svelte, SvelteKit, or framework lifecycle cleanup | [references/framework-patterns.md](references/framework-patterns.md) |
+| Value mapping, randomization, snapping, scoped selectors, helper utilities | [references/utils-patterns.md](references/utils-patterns.md) |
+| Flip, Draggable, SplitText, SVG, ScrollSmoother, and other GSAP plugins | [references/plugin-selection.md](references/plugin-selection.md) |
 | Reduced motion, cleanup, transform performance | [references/performance-accessibility.md](references/performance-accessibility.md) |
 
 When the user asks for an animation library without naming one, prefer GSAP for timelines, scroll-driven animation, framework-agnostic animation, runtime control, or coordinated multi-element motion. If the project or user has already chosen another library, respect that choice unless they ask to compare or migrate.
@@ -72,9 +74,9 @@ When the user asks for an animation library without naming one, prefer GSAP for
 Always inspect the target project before proposing implementation:
 
 ```bash
-grep -E '"gsap"|"@gsap/react"|"framer-motion"|"@motionone/dom"|"animejs"|"motion"' package.json
-grep -rn "gsap\\.|ScrollTrigger|useGSAP|registerPlugin" src --include="*.js" --include="*.jsx" --include="*.ts" --include="*.tsx" 2>/dev/null
-grep -rn "prefers-reduced-motion|transition|@keyframes" src --include="*.css" --include="*.scss" --include="*.tsx" --include="*.jsx" 2>/dev/null
+grep -E '"gsap"|"@gsap/react"|"vue"|"svelte"|"nuxt"|"framer-motion"|"@motionone/dom"|"animejs"|"motion"' package.json
+grep -rn "gsap\\.|ScrollTrigger|useGSAP|registerPlugin|gsap.utils" src --include="*.js" --include="*.jsx" --include="*.ts" --include="*.tsx" --include="*.vue" --include="*.svelte" 2>/dev/null
+grep -rn "prefers-reduced-motion|transition|@keyframes" src --include="*.css" --include="*.scss" --include="*.tsx" --include="*.jsx" --include="*.vue" --include="*.svelte" 2>/dev/null
 ```
 
 If `gsap` is not installed, ask before adding it. If React `useGSAP()` is needed and `@gsap/react` is not installed, ask before adding it. This skill teaches target projects how to use GSAP; it does not add GSAP to skilly-hand itself.
@@ -106,9 +108,10 @@ React and Next.js:
 
 Other frameworks:
 
-- Run GSAP setup after DOM nodes exist.
-- Scope selectors to the component root where possible.
-- Revert GSAP contexts, matchMedia instances, ScrollTriggers, and event listeners during component teardown.
+- Run GSAP setup after DOM nodes exist, such as Vue `onMounted()` or Svelte `onMount()`.
+- Scope selectors to the component root with `gsap.context(callback, scope)` where possible.
+- Revert GSAP contexts, matchMedia instances, ScrollTriggers, split text, and event listeners during component teardown.
+- Register plugins once at app/module level instead of inside render paths.
 
 ---
 
@@ -142,8 +145,11 @@ grep -rn "gsap\\.|ScrollTrigger|useGSAP|registerPlugin" src --include="*.js" --i
 ## Resources
 
 - Source map: [references/official-source-map.md](references/official-source-map.md)
+- Official GSAP AI skills repository: https://github.com/greensock/gsap-skills
 - Core patterns: [references/core-patterns.md](references/core-patterns.md)
 - React patterns: [references/react-patterns.md](references/react-patterns.md)
+- Framework patterns: [references/framework-patterns.md](references/framework-patterns.md)
 - ScrollTrigger patterns: [references/scrolltrigger-patterns.md](references/scrolltrigger-patterns.md)
+- Utility patterns: [references/utils-patterns.md](references/utils-patterns.md)
 - Plugin selection: [references/plugin-selection.md](references/plugin-selection.md)
 - Performance and accessibility: [references/performance-accessibility.md](references/performance-accessibility.md)

package/catalog/skills/gsap-animation/manifest.json

@@ -1,20 +1,20 @@
 {
   "id": "gsap-animation",
   "title": "GSAP Animation",
-  "description": "Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, JavaScript animation libraries, or advanced UI animation.",
+  "description": "Guide GSAP animation implementation using only official GSAP documentation and the official greensock/gsap-skills source material. Trigger: implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, gsap.utils, Vue/Svelte/Nuxt animation, GSAP plugins, JavaScript animation libraries, or advanced UI animation.",
   "portable": true,
   "tags": ["frontend", "animation", "motion", "gsap", "workflow"],
-  "detectors": ["react", "nextjs", "angular", "vite", "tailwindcss", "storybook"],
+  "detectors": ["react", "nextjs", "angular", "vue", "svelte", "nuxt", "vite", "tailwindcss", "storybook"],
   "detectionTriggers": ["auto"],
   "installsFor": ["all"],
   "agentSupport": ["codex", "claude", "cursor", "gemini", "copilot", "antigravity", "windsurf", "trae"],
   "skillMetadata": {
     "author": "skilly-hand",
-    "last-edit": "2026-05-03",
+    "last-edit": "2026-05-23",
     "license": "Apache-2.0",
-    "version": "1.0.0",
-    "changelog": "Added aggregate GSAP animation guidance backed by official GSAP docs and official GSAP AI skills; improves frontend motion implementation with verified timelines, ScrollTrigger, React cleanup, plugin, performance, and accessibility patterns; affects frontend animation routing and catalog discovery",
-    "auto-invoke": "Implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, JavaScript animation libraries, or advanced UI animation",
+    "version": "1.1.0",
+    "changelog": "Expanded GSAP catalog guidance with utilities, non-React framework patterns, official plugin availability, and upstream skill routing; improves official-source coverage and trigger precision; affects GSAP animation skill routing, catalog discovery, and implementation references",
+    "auto-invoke": "Implementing, reviewing, or choosing GSAP for frontend motion, timelines, ScrollTrigger, React useGSAP, gsap.utils, Vue/Svelte/Nuxt animation, GSAP plugins, JavaScript animation libraries, or advanced UI animation",
     "allowed-tools": ["Read", "Edit", "Write", "Glob", "Grep", "Bash", "WebFetch", "WebSearch", "Task", "SubAgent"]
   },
   "files": [
@@ -22,7 +22,9 @@
     { "path": "references/official-source-map.md", "kind": "reference" },
     { "path": "references/core-patterns.md", "kind": "reference" },
     { "path": "references/react-patterns.md", "kind": "reference" },
+    { "path": "references/framework-patterns.md", "kind": "reference" },
     { "path": "references/scrolltrigger-patterns.md", "kind": "reference" },
+    { "path": "references/utils-patterns.md", "kind": "reference" },
     { "path": "references/plugin-selection.md", "kind": "reference" },
     { "path": "references/performance-accessibility.md", "kind": "reference" }
   ],

package/catalog/skills/gsap-animation/references/core-patterns.md

@@ -1,6 +1,6 @@
 # GSAP Core Patterns
 
-Extracted: 2026-05-03
+Extracted: 2026-05-23
 
 Sources:
 
@@ -48,6 +48,26 @@ Use timelines for sequences, overlap, labels, modular choreography, or playback
 
 Prefer a timeline over stacking multiple `delay` values. Use the position parameter for offsets and overlaps, and labels when named positions make later control easier.
 
+Use timeline defaults when child tweens share duration, ease, or other common vars:
+
+```js
+const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
+tl.to(".a", { x: 100 })
+  .to(".b", { y: 50 }, "<0.15");
+```
+
+Common position parameters:
+
+- `0`: absolute start time.
+- `"+=0.5"` or `"-=0.2"`: relative offset from the previous insertion point.
+- `"<"`: start with the most recently added animation.
+- `">"`: start after the most recently added animation.
+- `"label"` or `"label+=0.2"`: start at or near a named label.
+
+Use playback methods such as `play()`, `pause()`, `reverse()`, `restart()`, `time()`, and `progress()` only when runtime control is required.
+
+When using ScrollTrigger with a sequence, attach ScrollTrigger to the top-level tween or timeline rather than nested child tweens.
+
 ## Properties and Values
 
 - Use camelCase property names in GSAP vars.

package/catalog/skills/gsap-animation/references/framework-patterns.md

@@ -0,0 +1,79 @@
+# GSAP Framework Patterns
+
+Extracted: 2026-05-23
+
+Sources:
+
+- https://gsap.com/docs/v3/GSAP/gsap.context()/
+- https://gsap.com/docs/v3/Plugins/ScrollTrigger/
+- https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-frameworks/SKILL.md
+
+## When to Use
+
+Use this reference for Vue, Nuxt, Svelte, SvelteKit, and other component frameworks that are not React. For React and Next.js, prefer [react-patterns.md](react-patterns.md).
+
+## Principles
+
+- Create tweens, timelines, and ScrollTriggers only after the component DOM exists.
+- Scope selector text to a component root with `gsap.context(callback, scope)`.
+- Revert the context during unmount/destroy so animations, inline styles, and ScrollTriggers are cleaned up.
+- Register plugins once at app/module level, not inside render paths or repeatedly called component bodies.
+- Call `ScrollTrigger.refresh()` after async content, route transitions, font loading, or layout changes that affect trigger positions.
+
+## Vue and Nuxt
+
+In Vue 3, create GSAP work in `onMounted()` and clean it up in `onUnmounted()`:
+
+```js
+import { onMounted, onUnmounted, ref } from "vue";
+import { gsap } from "gsap";
+
+const container = ref(null);
+let ctx;
+
+onMounted(() => {
+  ctx = gsap.context(() => {
+    gsap.from(".item", { autoAlpha: 0, y: 20, stagger: 0.08 });
+  }, container.value);
+});
+
+onUnmounted(() => {
+  ctx?.revert();
+});
+```
+
+For Nuxt, keep browser-only GSAP work in client-safe lifecycle and lazy-load less common plugins when bundle size matters.
+
+## Svelte and SvelteKit
+
+In Svelte, create GSAP work in `onMount()` and return cleanup:
+
+```js
+import { onMount } from "svelte";
+import { gsap } from "gsap";
+
+let container;
+
+onMount(() => {
+  const ctx = gsap.context(() => {
+    gsap.to(".box", { x: 100, duration: 0.6 });
+  }, container);
+
+  return () => ctx.revert();
+});
+```
+
+For SvelteKit, keep DOM-dependent GSAP setup on the client and avoid running it during server rendering.
+
+## ScrollTrigger Cleanup
+
+ScrollTriggers created inside `gsap.context()` are reverted with the context. Place `scrollTrigger` configs and `ScrollTrigger.create()` calls inside the same context as related tweens or timelines.
+
+When trigger positions depend on data, images, fonts, or route transitions, refresh after the DOM has settled.
+
+## Guardrails
+
+- Do not create GSAP animations before component DOM refs are available.
+- Do not use unscoped selector strings in reusable component instances.
+- Do not skip teardown; detached DOM nodes with live animations or ScrollTriggers cause leaks and stale callbacks.
+- Do not register plugins in reactive code that runs frequently.

package/catalog/skills/gsap-animation/references/official-source-map.md

@@ -1,6 +1,6 @@
 # Official GSAP Source Map
 
-Extracted: 2026-05-03
+Extracted: 2026-05-23
 
 This skill may only use official GSAP sources. The official GSAP docs page links the official `greensock/gsap-skills` repository as "AI Skills", so that repository is accepted as source material for agent-oriented guidance.
 
@@ -22,9 +22,14 @@ This skill may only use official GSAP sources. The official GSAP docs page links
 | Source | Use |
 | --- | --- |
 | https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-core/SKILL.md | Agent-oriented core tween, transform, easing, `matchMedia()`, and recommendation guidance |
+| https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-timeline/SKILL.md | Agent-oriented timeline sequencing, position parameters, labels, nesting, playback, and ScrollTrigger placement guidance |
+| https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-plugins/SKILL.md | Agent-oriented plugin selection, registration, install/licensing, SplitText, MorphSVG, DrawSVG, Draggable, Flip, and related plugin guidance |
+| https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-utils/SKILL.md | Agent-oriented `gsap.utils` guidance for mapping, clamping, snapping, randomization, selectors, arrays, wrapping, and piping |
 | https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-react/SKILL.md | Agent-oriented React, `useGSAP()`, context, cleanup, SSR, and callback guidance |
 | https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-scrolltrigger/SKILL.md | Agent-oriented ScrollTrigger registration, scroll-linked animation, pin, scrub, and cleanup guidance |
 | https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-performance/SKILL.md | Agent-oriented transform/performance cautions |
+| https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-frameworks/SKILL.md | Agent-oriented Vue, Nuxt, Svelte, SvelteKit, lifecycle, scoping, and cleanup guidance |
+| https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/llms.txt | Official AI agent skill index, trigger terms, plugin availability note, and upstream routing map |
 
 ## Verification Rule
 

package/catalog/skills/gsap-animation/references/plugin-selection.md

@@ -1,6 +1,6 @@
 # GSAP Plugin Selection
 
-Extracted: 2026-05-03
+Extracted: 2026-05-23
 
 Sources:
 
@@ -15,6 +15,8 @@ Use the smallest GSAP surface that solves the motion problem. Core tweens and ti
 
 Register every plugin used with `gsap.registerPlugin(...)`. Official installation guidance recommends registration in module environments so build tools do not drop plugins during tree shaking.
 
+All GSAP plugins are available from the public `gsap` package, including formerly Club GSAP plugins such as `SplitText`, `MorphSVGPlugin`, and `DrawSVGPlugin`. Do not suggest a private GreenSock registry, `.npmrc` auth token, license key, or paid Club GSAP membership for plugin access.
+
 ## Selection Matrix
 
 | Need | Official GSAP Tool |

package/catalog/skills/gsap-animation/references/utils-patterns.md

@@ -0,0 +1,68 @@
+# GSAP Utility Patterns
+
+Extracted: 2026-05-23
+
+Sources:
+
+- https://gsap.com/docs/v3/GSAP/UtilityMethods/
+- https://raw.githubusercontent.com/greensock/gsap-skills/main/skills/gsap-utils/SKILL.md
+
+## When to Use
+
+Use `gsap.utils` when animation logic needs value mapping, clamping, snapping, randomization, reusable helper functions, scoped selectors, or array normalization. Utilities do not need plugin registration.
+
+Use utility functions inside tween vars, ScrollTrigger callbacks, pointer handlers, or plain JavaScript that drives GSAP state.
+
+## Function Form
+
+Many utilities accept the value to transform as the final argument. When that value is omitted, the utility returns a reusable function that accepts the value later. Use this form when the same range or rule is applied repeatedly.
+
+`random()` is the notable exception: pass `true` as the final argument when you need a reusable random function.
+
+## Selection Matrix
+
+| Need | Utility |
+| --- | --- |
+| Keep a number inside a range | `gsap.utils.clamp(min, max, value?)` |
+| Convert a number from one range to another | `gsap.utils.mapRange(inMin, inMax, outMin, outMax, value?)` |
+| Convert a range value to progress from `0` to `1` | `gsap.utils.normalize(min, max, value?)` |
+| Blend numbers, colors, arrays, or matching objects by progress | `gsap.utils.interpolate(start, end, progress?)` |
+| Pick random numbers or array items | `gsap.utils.random(...)` |
+| Align values to increments or allowed values | `gsap.utils.snap(snapTo, value?)` |
+| Convert selectors, NodeLists, or single elements into arrays | `gsap.utils.toArray(value, scope?)` |
+| Create a selector scoped to a component/container | `gsap.utils.selector(scope)` |
+| Cycle a value through a range | `gsap.utils.wrap(min, max, value?)` |
+| Compose multiple transforms into one function | `gsap.utils.pipe(...functions)` |
+
+## Patterns
+
+Use function-form utilities for repeated callback work:
+
+```js
+const toDegrees = gsap.utils.mapRange(0, 1, 0, 360);
+const snapProgress = gsap.utils.snap(0.1);
+
+function onUpdate(progress) {
+  return snapProgress(toDegrees(progress));
+}
+```
+
+Use scoped selectors in components when direct refs are too verbose:
+
+```js
+const q = gsap.utils.selector(container);
+gsap.to(q(".item"), { y: 24, stagger: 0.05 });
+```
+
+Use string random values inside tween vars when each target should receive its own value:
+
+```js
+gsap.to(".particle", { x: "random(-100, 100, 5)", y: "random(-60, 60, 5)" });
+```
+
+## Guardrails
+
+- Do not use numeric range utilities for unit conversion; use documented unit helpers when units matter.
+- Prefer `toArray()` when downstream logic expects a real array instead of a NodeList.
+- Prefer `selector(scope)` or `toArray(value, scope)` for framework components so selectors do not leak outside the component.
+- Check official utility docs before using helpers not listed here.

package/catalog/templates/AGENTS.template.md

@@ -53,5 +53,5 @@ Chaining notations document integrated workflows where multiple skills are seque
 ```text
 Updating root AGENTS.md guidance
   -> agents-root-orchestrator
-  -> skill-creator (if reusable workflow docs changed)
+  -> forge-me-a-skill (if reusable workflow docs changed)
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/skilly-hand",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "repository": {

package/packages/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/catalog",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }

package/packages/catalog/src/index.js

@@ -562,7 +562,7 @@ export function renderAgentsMarkdown({ skills, detections, generatedAt, projectN
     "| --------- | ----------------------- |",
     "| Planning feature work, bug fixes, and multi-phase implementation | `spec-driven-development` |",
     "| Executing approved implementation plans | `spec-driven-development` -> task-specific skills |",
-    "| Creating or updating reusable skills | `skill-creator` |",
+    "| Creating or updating reusable skills | `forge-me-a-skill` |",
     "| Creating or updating root AGENTS orchestration guidance | `agents-root-orchestrator` |",
     "",
     "## When",
@@ -598,14 +598,14 @@ export function renderAgentsMarkdown({ skills, detections, generatedAt, projectN
     "```text",
     "Updating root AGENTS.md guidance",
     "  -> agents-root-orchestrator",
-    "  -> skill-creator (if reusable workflow docs changed)",
+    "  -> forge-me-a-skill (if reusable workflow docs changed)",
     "```",
     "",
     "### Skill Introduction Workflow",
     "",
     "```text",
     "Asking for a new reusable skill",
-    "  -> skill-creator",
+    "  -> forge-me-a-skill",
     "  -> spec-driven-development",
     "  -> agents-root-orchestrator",
     "```",

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/cli",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module",
   "bin": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/core",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }

package/packages/detectors/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilly-hand/detectors",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "private": true,
   "type": "module"
 }