Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/chama-x/groundrules/gsapnpx skills add chama-x/GroundRules --skill gsapgit clone --depth 1 https://github.com/chama-x/GroundRulesWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00023 | $0.00330 |
| Opus 5 | $0.00012 | $0.00165 |
| Sonnet 5 | $0.00005 | $0.00066 |
| Haiku 4.5 | $0.00002 | $0.00033 |
Grade A, and why
gsap scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
GSAP Architecture Configuration
This is a configuration profile, not a textbook. You already know the GSAP API. Apply these constraints strictly when writing GSAP code for this project:
React Integration
- Hook: ALWAYS use the
@gsap/reactuseGSAPhook. Never use rawuseEffectoruseLayoutEffectfor GSAP. - Scope: Always pass the container ref to the
useGSAPscope{ scope: containerRef }. - Cleanup: Rely on
useGSAP's automatic cleanup. Do not manually kill tweens unless dynamically created outside the initial render cycle.
ScrollTrigger Rules
- Pinning: Pin to a specific local DOM node ref, never to
document.bodyorwindow. - Markers: Disable markers in production.
- Refresh: If layout changes dynamically (images loading, accordions), ensure
ScrollTrigger.refresh()is called, but debounce it.
Performance Constraints
- Properties: Animate ONLY composited properties:
transform(x, y, scale, rotation) andopacity. - Layout Thrashing: NEVER animate width, height, top, left, margin, or padding. If you must scale a layout element, use
transform: scale(). - Will-Change: Use
will-change: transformcautiously, only on elements currently animating or about to animate.
What ships with it
7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 24 lines · 23 tokens per session scan A 7075d07a8188
gsap is a skill published in the GitHub repository chama-x/GroundRules (5 stars, last pushed 19d ago), licensed MIT. It adds 23 tokens to every session and 330 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance…
scaffold-vite-react
Scaffold Vite + React POC frontend in delivery worktree output directory.
react-developer
Expert knowledge in React development, hooks, state management, and modern React patterns.
animation-framework-integration
Standards for integrating GSAP into React, Vue, and Svelte while ensuring clean memory management.
react-component
Fixture stack skill — build a React component.
Desenvolvimento de Aplicativos Móveis com React Native
Esta skill ensina como desenvolver aplicativos móveis utilizando o framework React Native, incluindo a criação de componentes e integração com APIs.