$npx -y skills add getpaperclipai/paperclip --skill paperclip-capsulesGenerate, implement, or review Paperclip capsule visuals. Use when the user asks for Paperclip capsule art, capsule banks, agent capsule visuals, heartbeat status capsules, capsule identicons, capsule graphic-generator output, or validation of Paperclip capsule brand usage.
| 1 | # Paperclip Capsules |
| 2 | |
| 3 | Use this skill when creating or checking Paperclip capsule visuals. The central rule is simple: **the capsule is the agent**. A capsule is not generic chrome, a button shape, a random status pill, or background decoration. |
| 4 | |
| 5 | The one approved decorative exception is the canonical hero capsule bank. Treat it as a specific Paperclip brand surface, not a license to make arbitrary capsule wallpaper. |
| 6 | |
| 7 | ## When to Use |
| 8 | |
| 9 | - Generating Paperclip capsule art, agent avatars, capsule fields, hero capsule banks, or seeded capsule identicons. |
| 10 | - Implementing an individual agent capsule in product UI. |
| 11 | - Rendering heartbeat status capsules for agent status. |
| 12 | - Building Paperclip feature videos or marketing graphics that use the capsule motif. |
| 13 | - Reviewing a design for capsule brand correctness. |
| 14 | |
| 15 | ## When Not to Use |
| 16 | |
| 17 | - Generic rounded pills, badges, buttons, tags, nav items, or decorative blobs. |
| 18 | - Non-agent illustrations where capsules would only be visual texture. |
| 19 | - Product UI color choices unrelated to agents or heartbeat status. |
| 20 | - Replacing the app's existing `AgentCapsule` or status-color helpers from memory. |
| 21 | |
| 22 | ## Non-Negotiable Rules |
| 23 | |
| 24 | - **Capsules represent agents.** If the surface does not involve agents, do not add capsules. |
| 25 | - **Do not use the agent capsule palette outside capsules.** Never apply agent gradients to buttons, text, page backgrounds, cards, or generic UI chrome. |
| 26 | - **Keep capsule families separate.** App individual capsules, heartbeat status capsules, website marketing capsules, video capsules, seeded identicons, and the hero bank have different data. |
| 27 | - **Hero bank is the only decorative exception.** Use the canonical bank spec; do not hand-roll a new bank. |
| 28 | - **Record reproducibility data.** For generated assets, record seed, template, palette, dimensions, and source workflow. |
| 29 | - **Respect reduced motion.** Any pulsing, blinking, breathing, wave, or fill-rise animation needs a static reduced-motion fallback. |
| 30 | |
| 31 | ## Choose the Right Capsule Surface |
| 32 | |
| 33 | Use **individual agent capsules** when one capsule equals one agent in product UI, onboarding, org surfaces, or avatars. Read `references/individual-status-capsules.md` before implementing or changing UI behavior. |
| 34 | |
| 35 | Use **heartbeat status capsules** for small solid status markers: idle/active gray, running blue pulse, paused amber, error red blink. These are not tall gradient identity capsules. |
| 36 | |
| 37 | Use the **hero capsule bank** only for brand hero imagery, feature-video hero scenes, or approved marketing motif work. Read `references/hero-capsule-bank.md` before drawing it. |
| 38 | |
| 39 | Use **graphic-generator layouts** when the task asks for capsule graphics such as blend rows, chains, grids, icon marks, or hero compositions. Prefer seeded tools and exportable workflows; read `references/generator-workflows.md`. |
| 40 | |
| 41 | Use **seeded identicons/profile pills** when an agent needs a reproducible personal capsule mark. Read `references/identicon-prototyper.md` before choosing variants, color schemes, dither algorithms, density, sheen, aurora, mesh, motion, or exports. |
| 42 | |
| 43 | ## Implementation Workflow |
| 44 | |
| 45 | 1. Identify which capsule family you are working in: individual agent, status capsule, hero bank, generator layout, or identicon. |
| 46 | 2. Load the matching reference file from this skill. |
| 47 | 3. Prefer existing source implementations: |
| 48 | - Product UI: `ui/src/components/AgentCapsule.tsx`, `ui/src/index.css`, and `ui/src/lib/status-colors.ts`. |
| 49 | - Hero bank: canonical spec in `references/hero-capsule-bank.md`. |
| 50 | - Video work: pair this skill with the Paperclip feature-video HyperFrames skill when available. |
| 51 | 4. If generating an artifact, choose a reproducible workflow and write down the seed/config. |
| 52 | 5. Verify that the result still reads as agent-related. Remove capsules if they became decoration. |
| 53 | 6. Attach or otherwise expose generated deliverables when doing issue work, and name the exact workflow used. |
| 54 | |
| 55 | ## Output Expectations |
| 56 | |
| 57 | For any generated capsule asset, include: |
| 58 | |
| 59 | - Capsule family: `individual-agent`, `heartbeat-status`, `hero-bank`, `graphic-generator`, or `identicon`. |
| 60 | - Source workflow or implementation path. |
| 61 | - Seed and config where available. |
| 62 | - Dimensions, format, and renderer. |
| 63 | - Any divergence from canonical Paperclip rendering. |
| 64 | |
| 65 | For code changes, include targeted checks that exercise the edited surface. For visuals, include screenshots or inspectable SVG/PNG/HTML when possible. |
| 66 | |
| 67 | ## Validation Checklist |
| 68 | |
| 69 | - Does each capsule represent an agent, agent state, o |