Paperclip Capsules
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.
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.
When to Use
- Generating Paperclip capsule art, agent avatars, capsule fields, hero capsule banks, or seeded capsule identicons.
- Implementing an individual agent capsule in product UI.
- Rendering heartbeat status capsules for agent status.
- Building Paperclip feature videos or marketing graphics that use the capsule motif.
- Reviewing a design for capsule brand correctness.
When Not to Use
- Generic rounded pills, badges, buttons, tags, nav items, or decorative blobs.
- Non-agent illustrations where capsules would only be visual texture.
- Product UI color choices unrelated to agents or heartbeat status.
- Replacing the app's existing
AgentCapsule or status-color helpers from memory.
Non-Negotiable Rules
- Capsules represent agents. If the surface does not involve agents, do not add capsules.
- Do not use the agent capsule palette outside capsules. Never apply agent gradients to buttons, text, page backgrounds, cards, or generic UI chrome.
- Keep capsule families separate. App individual capsules, heartbeat status capsules, website marketing capsules, video capsules, seeded identicons, and the hero bank have different data.
- Hero bank is the only decorative exception. Use the canonical bank spec; do not hand-roll a new bank.
- Record reproducibility data. For generated assets, record seed, template, palette, dimensions, and source workflow.
- Respect reduced motion. Any pulsing, blinking, breathing, wave, or fill-rise animation needs a static reduced-motion fallback.
Choose the Right Capsule Surface
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.
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.
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.
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.
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.
Implementation Workflow
- Identify which capsule family you are working in: individual agent, status capsule, hero bank, generator layout, or identicon.
- Load the matching reference file from this skill.
- Prefer existing source implementations:
- Product UI:
ui/src/components/AgentCapsule.tsx, ui/src/index.css, and ui/src/lib/status-colors.ts.
- Hero bank: canonical spec in
references/hero-capsule-bank.md.
- Video work: pair this skill with the Paperclip feature-video HyperFrames skill when available.
- If generating an artifact, choose a reproducible workflow and write down the seed/config.
- Verify that the result still reads as agent-related. Remove capsules if they became decoration.
- Attach or otherwise expose generated deliverables when doing issue work, and name the exact workflow used.
Output Expectations
For any generated capsule asset, include:
- Capsule family:
individual-agent, heartbeat-status, hero-bank, graphic-generator, or identicon.
- Source workflow or implementation path.
- Seed and config where available.
- Dimensions, format, and renderer.
- Any divergence from canonical Paperclip rendering.
For code changes, include targeted checks that exercise the edited surface. For visuals, include screenshots or inspectable SVG/PNG/HTML when possible.
Validation Checklist
- Does each capsule represent an agent, agent state, or the canonical hero-bank exception?
- Are gradients confined to capsule shapes?
- Are app, website, video, identicon, and hero-bank palettes kept separate?
- Is motion reduced or removed under reduced-motion settings?
- Is the source path or reproducible seed/config recorded?
- Are generated files attached or linked as inspectable deliverables for issue work?
References
references/individual-status-capsules.md - product app capsules, heartbeat status capsules, palette caveats, and reduced-motion rules.
references/hero-capsule-bank.md - canonical hero-bank geometry, palette, grain, wave, crop, and rendering checklist.
references/generator-workflows.md - website generator and external graphic-generator workflows.
references/identicon-prototyper.md - deterministic profile-pill variants, color schemes, dither algorithms, density behavior, motion, export/share controls, and recommended combinations.
1---
2name: paperclip-capsules
3description: Generate, implement, or review Paperclip capsule visuals. Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation.
4key: paperclipai/bundled/product/paperclip-capsules
5recommendedForRoles:
6 - designer
7 - product
8 - engineer
9 - marketing
10tags:
11 - paperclip
12 - brand
13 - capsules
14 - agents
15 - visual-design
16 - hyperframes
17metadata:
18 source: https://skillmd.com/skills/paperclipai/paperclip-capsules
19---
20
21# Paperclip Capsules
22
23Use 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.
24
25The 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.
26
27## When to Use
28
29- Generating Paperclip capsule art, agent avatars, capsule fields, hero capsule banks, or seeded capsule identicons.
30- Implementing an individual agent capsule in product UI.
31- Rendering heartbeat status capsules for agent status.
32- Building Paperclip feature videos or marketing graphics that use the capsule motif.
33- Reviewing a design for capsule brand correctness.
34
35## When Not to Use
36
37- Generic rounded pills, badges, buttons, tags, nav items, or decorative blobs.
38- Non-agent illustrations where capsules would only be visual texture.
39- Product UI color choices unrelated to agents or heartbeat status.
40- Replacing the app's existing `AgentCapsule` or status-color helpers from memory.
41
42## Non-Negotiable Rules
43
44- **Capsules represent agents.** If the surface does not involve agents, do not add capsules.
45- **Do not use the agent capsule palette outside capsules.** Never apply agent gradients to buttons, text, page backgrounds, cards, or generic UI chrome.
46- **Keep capsule families separate.** App individual capsules, heartbeat status capsules, website marketing capsules, video capsules, seeded identicons, and the hero bank have different data.
47- **Hero bank is the only decorative exception.** Use the canonical bank spec; do not hand-roll a new bank.
48- **Record reproducibility data.** For generated assets, record seed, template, palette, dimensions, and source workflow.
49- **Respect reduced motion.** Any pulsing, blinking, breathing, wave, or fill-rise animation needs a static reduced-motion fallback.
50
51## Choose the Right Capsule Surface
52
53Use **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.
54
55Use **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.
56
57Use 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.
58
59Use **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`.
60
61Use **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.
62
63## Implementation Workflow
64
651. Identify which capsule family you are working in: individual agent, status capsule, hero bank, generator layout, or identicon.
662. Load the matching reference file from this skill.
673. Prefer existing source implementations:
68 - Product UI: `ui/src/components/AgentCapsule.tsx`, `ui/src/index.css`, and `ui/src/lib/status-colors.ts`.
69 - Hero bank: canonical spec in `references/hero-capsule-bank.md`.
70 - Video work: pair this skill with the Paperclip feature-video HyperFrames skill when available.
714. If generating an artifact, choose a reproducible workflow and write down the seed/config.
725. Verify that the result still reads as agent-related. Remove capsules if they became decoration.
736. Attach or otherwise expose generated deliverables when doing issue work, and name the exact workflow used.
74
75## Output Expectations
76
77For any generated capsule asset, include:
78
79- Capsule family: `individual-agent`, `heartbeat-status`, `hero-bank`, `graphic-generator`, or `identicon`.
80- Source workflow or implementation path.
81- Seed and config where available.
82- Dimensions, format, and renderer.
83- Any divergence from canonical Paperclip rendering.
84
85For code changes, include targeted checks that exercise the edited surface. For visuals, include screenshots or inspectable SVG/PNG/HTML when possible.
86
87## Validation Checklist
88
89- Does each capsule represent an agent, agent state, or the canonical hero-bank exception?
90- Are gradients confined to capsule shapes?
91- Are app, website, video, identicon, and hero-bank palettes kept separate?
92- Is motion reduced or removed under reduced-motion settings?
93- Is the source path or reproducible seed/config recorded?
94- Are generated files attached or linked as inspectable deliverables for issue work?
95
96## References
97
98- `references/individual-status-capsules.md` - product app capsules, heartbeat status capsules, palette caveats, and reduced-motion rules.
99- `references/hero-capsule-bank.md` - canonical hero-bank geometry, palette, grain, wave, crop, and rendering checklist.
100- `references/generator-workflows.md` - website generator and external graphic-generator workflows.
101- `references/identicon-prototyper.md` - deterministic profile-pill variants, color schemes, dither algorithms, density behavior, motion, export/share controls, and recommended combinations.