Agent skill

Paperclip Capsules

by paperclipai in paperclipai/paperclip

Generate, implement, or review Paperclip capsule visuals. An agent skill from paperclipai/paperclip.

MITAuto-check passed

Install Paperclip Capsules

skills CLI
$ npx skills add paperclipai/paperclip --skill paperclip-capsules -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install paperclipai/paperclip paperclip-capsules --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/paperclipai/paperclip.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skills-catalog/catalog/bundled/product/paperclip-capsules .claude/skills/paperclip-capsules && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paperclip-capsules
GitHub stars
100k
Token cost
~1.5k tokens
SKILL.md length
678 words
Files
5 (incl. references)
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Generate, implement, or review Paperclip capsule visuals. An agent skill from paperclipai/paperclip.

  • Works in 6 steps: Identify which capsule family you are… → Load the matching reference file from… → Prefer existing source implementations → …
  • Heartbeat status capsules
  • SKILL.md covers When to Use, When Not to Use, Non-Negotiable Rules and Choose the Right Capsule Surface, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Paperclip Capsules is an agent skill from paperclipai/paperclip. Generate, implement, or review Paperclip capsule visuals. Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/generator-workflows.md`, `references/hero-capsule-bank.md` and `references/identicon-prototyper.md`).

The repository describes itself as: The open-source app everyone uses to manage agents at work. The licence is MIT.

When your agent uses it

  • Heartbeat status capsules
  • Brand-usage validation

Example prompts

  • “/paperclip-capsules”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Identify which capsule family you are working in: individual agent, status capsule, hero bank, generator layout, or identicon.
  2. Load the matching reference file from this skill.
  3. Prefer existing source implementations
  4. If generating an artifact, choose a reproducible workflow and write down the seed/config.
  5. Verify that the result still reads as agent-related. Remove capsules if they became decoration.
  6. Attach or otherwise expose generated deliverables when doing issue work, and name the exact workflow used.

What it can do on your machine

Read from SKILL.md and the folder at commit de9ab8e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paperclip Capsules loads about 1.5k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 678 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from paperclipai/paperclip at commit de9ab8e, republished under its MIT licence (© paperclipai). 678 words, ~1,458 tokens.

Download SKILL.mdSave it as .claude/skills/paperclip-capsules/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
paperclip-capsules
description
Generate, implement, or review Paperclip capsule visuals. Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation.
key
paperclipai/bundled/product/paperclip-capsules
recommendedForRoles
designer, product, engineer, marketing
tags
paperclip, brand, capsules, agents, visual-design, hyperframes

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.

Show full SKILL.md (268 more words)Show less

Implementation Workflow

  1. Identify which capsule family you are working in: individual agent, status capsule, hero bank, generator layout, or identicon.
  2. Load the matching reference file from this skill.
  3. 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.
  4. If generating an artifact, choose a reproducible workflow and write down the seed/config.
  5. Verify that the result still reads as agent-related. Remove capsules if they became decoration.
  6. 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.

© paperclipai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in packages/skills-catalog/catalog/bundled/product/paperclip-capsules of paperclipai/paperclip.

  • SKILL.md
  • references/generator-workflows.md
  • references/hero-capsule-bank.md
  • references/identicon-prototyper.md
  • references/individual-status-capsules.md

Open the folder on GitHubat commit de9ab8e

Compare with similar skills

Paperclip Capsules next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paperclip Capsules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paperclip Capsules this skillpaperclipai/paperclip100k—~1.5kAutomated safety check: PassMIT
Visualizeopenclaw/openclaw392k—~2.4kAutomated safety check: PassMIT
Implementsickn33/agentic-awesome-skills47k5 repos~306Automated safety check: PassMIT
PaperclipK-Dense-AI/scientific-agent-skills48k1 repos~3.2kAutomated safety check: NotesMIT
Visual Stylecalesthio/OpenMontage66k—~1.5kAutomated safety check: PassAGPL-3.0
D3 Visualizationnexu-io/open-design100k—~523Automated safety check: PassApache-2.0

Similar skills

  • Visualize

    openclaw/openclaw

    Create inline visuals for code and explanations, or author persistent OpenClaw dashboard widgets with showwidget.

    392k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Implement

    sickn33/agentic-awesome-skills

    Implement a piece of work based on a PRD or set of issues. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 5 repos~306 tokens
    Product & Project ManagementAuto-check passed
  • Paperclip

    K-Dense-AI/scientific-agent-skills

    Searches and reads biomedical papers, FDA/PMDA/EMA documents, clinical trials, and protein records with the GXL Paperclip CLI and Python SDK.

    48k GitHub starsUsed in 1 repo~3.2k tokens
    Research & ScienceAuto-check: notes
  • Visual Style

    calesthio/OpenMontage

    Create, extract, and apply portable visual design systems via visual-style.md files.

    66k GitHub stars~1.5k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • D3 Visualization

    nexu-io/open-design

    Teaches the agent to produce D3 charts and interactive data visualizations.

    100k GitHub stars~523 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Algorithmic Art

    nexu-io/open-design

    Create generative art using p5.js with seeded randomness so every render is reproducible.

    100k GitHub stars~351 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from paperclipai/paperclip

All 60 skills in this repo
  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    100k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    100k GitHub stars~9.6k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    A skill your agent uses for Paperclip-managed tasks and heartbeats: reading task context, delivering task documents or files, updating completion or blockers, coordinating or delegating work, and…

    100k GitHub stars~18k tokensUpdated today
    Auto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    100k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    100k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Paperclip Create Agent

    paperclipai/paperclip

    Create new agents in Paperclip with governance-aware hiring.

    100k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed

Questions about Paperclip Capsules

What does Paperclip Capsules do?

Generate, implement, or review Paperclip capsule visuals. An agent skill from paperclipai/paperclip. Paperclip Capsules is an agent skill from paperclipai/paperclip. Generate, implement, or review Paperclip capsule visuals.

When should I use Paperclip Capsules?

Paperclip Capsules fits situations like: heartbeat status capsules; brand-usage validation.

How do I install Paperclip Capsules in Claude Code?

Run `npx skills add paperclipai/paperclip --skill paperclip-capsules -a claude-code`. Or copy the skill folder (packages/skills-catalog/catalog/bundled/product/paperclip-capsules in paperclipai/paperclip) into .claude/skills/paperclip-capsules in your project. Claude Code loads it when a task matches its description.

How do I install Paperclip Capsules in Codex?

Run `npx skills add paperclipai/paperclip --skill paperclip-capsules -a codex`. Or copy the skill folder (packages/skills-catalog/catalog/bundled/product/paperclip-capsules in paperclipai/paperclip) into .agents/skills/paperclip-capsules in your project. Codex loads it when a task matches its description.

Can I use Paperclip Capsules in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paperclipai/paperclip --skill paperclip-capsules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paperclip-capsules, .gemini/skills/paperclip-capsules, .github/skills/paperclip-capsules and .opencode/skills/paperclip-capsules in your project.

What does Paperclip Capsules need to run?

SKILL.md names no scripts, command-line tools or credentials: Paperclip Capsules is instructions for the agent only.

Does Paperclip Capsules access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Paperclip Capsules safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Paperclip Capsules use?

Paperclip Capsules is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paperclip Capsules use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Paperclip Capsules?

Skills that share tags, products or a category with Paperclip Capsules: Visualize (openclaw/openclaw, 392k stars), Implement (sickn33/agentic-awesome-skills, 47k stars), Paperclip (K-Dense-AI/scientific-agent-skills, 48k stars) and Visual Style (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paperclip Capsules?

paperclipai (a GitHub organization) maintains it in paperclipai/paperclip, which has 99,905 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 11, 2026.

Source: paperclipai/paperclip on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.