CtrlK
BlogDocsLog inGet started
Tessl Logo

paperclip-capsules

Generate, implement, or review Paperclip capsule visuals. Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation.

68

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered skill body: tight rule-based writing, concrete file paths and output contracts, a sequenced workflow with verification, and exemplary progressive disclosure into four real, well-scoped reference files. The remaining headroom is minor — some redundant restatement of the hero-bank exception and no explicit failure-recovery loop.

Suggestions

Consolidate the hero-bank exception, which is stated in the intro, Non-Negotiable Rules, the surface-selection section, and the Validation Checklist — one canonical statement plus one checklist line would reclaim tokens.

Add a brief failure-recovery note to the workflow (e.g., what to do when the Validation Checklist fails or canonical source paths are missing) to close the feedback-loop gap in workflow clarity.

hero-capsule-bank.md's Source Precedence cites sibling-skill paths (references/capsule-bank-spec.md, references/brand-tokens.md, references/composition-recipes.md) that are not in this bundle; qualify them as external/optional so the workflow does not stall when they are absent.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: no space is spent explaining what capsules or design systems are, and every section carries rules rather than filler (e.g., "Use heartbeat status capsules for small solid status markers: idle/active gray, running blue pulse, paused amber, error red blink"). It is a 4 rather than 5 because the hero-bank exception is stated four times (intro, Non-Negotiable Rules, capsule-surface section, Validation Checklist) and the agent-representation rule is likewise repeated across three sections — small trims are available without losing clarity; it is well above the 3 anchor where unnecessary explanation appears.

4 / 5

Actionability

Guidance is concrete and executable for an orchestration skill: exact source paths ("ui/src/components/AgentCapsule.tsx", "ui/src/lib/status-colors.ts"), specific reference files to read per family, concrete status color semantics, and a defined output contract (family, workflow, seed/config, dimensions, divergences). Per the rubric's instruction-skill note, absence of code is not penalized, but it stops short of the 5 anchor because the actual rendering specs are entirely deferred to reference files and some steps (e.g., how to record reproducibility data) rely on the references; it is clearly above 3, which requires pseudocode or missing key details.

4 / 5

Workflow Clarity

The 6-step Implementation Workflow is clearly sequenced with a verification checkpoint ("Verify that the result still reads as agent-related. Remove capsules if they became decoration.") and is reinforced by a Validation Checklist section. It misses 5 because there is no feedback-loop handling (no 'if the check fails, do X' recovery guidance), and comfortably exceeds 3, where checkpoints would be absent or implicit — here the verify step and checklist are explicit. No destructive/batch cap applies.

4 / 5

Progressive Disclosure

The body is a genuine overview that splits detail into four one-level-deep reference files, all of which exist in the bundle and are well signaled both inline ("Read references/hero-capsule-bank.md before drawing it") and in a final References section with one-line descriptions. Reference files contain the deep specs (palettes, geometry, workflows, export controls) and do not chain into further skill-internal references, matching the 5 anchor's clean overview-plus-navigable-references structure.

5 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concise, explicit about both what the skill does and when to use it, with niche-specific trigger terms that make mis-triggering unlikely. The only weaknesses are moderate verb coverage and a few missing natural synonyms that appear in the body but not the description.

Suggestions

Add natural synonym triggers that appear in the body but not the description, e.g., 'agent avatars', 'hero capsule bank', or 'profile pills', to broaden trigger match without adding vagueness.

Consider mentioning the seeded/reproducible generation capability (e.g., 'seeded capsule generation') since it is a core differentiator covered prominently in the body.

DimensionReasoningScore

Specificity

The description lists three concrete actions ("Generate, implement, or review Paperclip capsule visuals") plus an enumerated set of artifact types ("capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation"), giving several specific capabilities with minor gaps in verb coverage. It falls below the 5 anchor because it names only three verbs rather than the multiple distinct actions of a comprehensive list (e.g., export, seed, validate appear in the body but not here), and above 3 because it goes well beyond naming the domain with 1-2 actions.

4 / 5

Completeness

Both parts are explicit: the what is "Generate, implement, or review Paperclip capsule visuals" and the when is "Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation" — a concrete 'Use for...' trigger clause mirroring the 5-anchor example structure. Not 4, because the when-clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

"capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation" gives good natural keyword coverage of the project's own vocabulary — terms a Paperclip user would actually say. It sits below the 5 anchor because a few natural synonyms used elsewhere in the skill (e.g., "agent avatars", "hero capsule bank", "profile pills") are absent, and above 3 because it covers the family-specific variants (heartbeat, identicon, bank) rather than just generic capsule language.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche ("Paperclip capsule visuals") with distinct, brand-specific triggers (heartbeat status capsules, identicons, capsule banks) that no generic design or UI skill would claim. It matches the 5 anchor: clear niche with distinct triggers and minimal conflict risk; adjacent anchors involve generic domains ("documents", "files") this description avoids entirely.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
paperclipai/paperclip
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.