create-paperclip-bundled-skill

Turn an idea, tweet, or task into a skill in the Paperclip skills catalog (packages/skills-catalog). Use when asked to FIND or MAKE a skill and publish it as a bundled/optional catalog skill: research prior art, reference or author it, add examples, regenerate the manifest, open a PR.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

88%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 highly actionable, well-sequenced workflow skill with concrete commands, validation checkpoints, and a PR checklist. It is efficient though not maximally lean, and relies on a single well-structured file rather than progressive file splitting.

Suggestions

Trim motivational framing (e.g. "The catalog is the shelf every Paperclip company browses and installs from, so the bar is...") to lift conciseness toward a 5.

Consider moving the catalog-ref.json builder rules and the full frontmatter spec into a references/ file signaled from the body, which would improve progressive-disclosure file splitting.

Confirm the referenced sibling example (examples/external-reference.md) actually ships alongside this skill, or note it as a repo-external path, to avoid a dangling reference.

Dimension	Reasoning	Score
Conciseness	The body is dense and mostly purposeful — concrete commands, rules, and gotchas dominate — but a few framing passages ("The catalog is the shelf every Paperclip company browses and installs from...") are mild over-explanation that could be trimmed, keeping it just below a 5.	4 / 5
Actionability	Provides copy-paste-ready commands throughout ("command -v xc && xc whoami", "xc get <post-url-or-id> --json", "gh search code --filename SKILL.md", "pnkg --filter @paperclipai/skills-catalog build:manifest") plus complete JSON and frontmatter templates, matching the fully-executable score-5 anchor.	5 / 5
Workflow Clarity	Steps 0–5 are clearly sequenced with explicit validation checkpoints ("validate # must report no errors", "pnkg --filter ... test"), a PR-diff checklist, and gotchas serving as error-recovery notes, fitting the score-5 anchor with feedback loops.	5 / 5
Progressive Disclosure	Well-organized into labeled sections with one-level-deep signaled references to repo docs (writing-a-skill.md, prepare-paperclip-pr, examples/external-reference.md), but as a single-file skill with no bundle files the content is not split across files, so it sits at good-structure rather than the ideal split of the score-5 anchor.	4 / 5
	Total	18 / 20 Passed

Description

92%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, specific description that names the domain, lists concrete procedure steps, and gives explicit use-trigger guidance in third-person imperative voice. The only soft spot is trigger-term breadth, which leans on a few phrases rather than a rich synonym set.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "research prior art, reference or author it, add examples, regenerate the manifest, open a PR" — giving comprehensive coverage of the procedure, matching the score-5 anchor rather than the score-4 anchor which expects minor gaps.	5 / 5
Completeness	Explicitly answers both what ("Turn an idea, tweet, or task into a skill in the Paperclip skills catalog") and when ("Use when asked to FIND or MAKE a skill and publish it as a bundled/optional catalog skill") with concrete trigger phrases, fitting the score-5 anchor.	5 / 5
Trigger Term Quality	Includes natural trigger phrases users would say ("idea, tweet, or task", "FIND or MAKE a skill", "publish", "open a PR") with good coverage, but lacks synonym/extension breadth that would push it to a 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — publishing to the Paperclip skills catalog as a bundled/optional skill — with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: paperclipai/paperclip
Path: .agents/skills/create-paperclip-bundled-skill/SKILL.md
Commit: bd1fdc2

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.