CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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.

An excellent procedural skill body: highly actionable commands, a clearly sequenced workflow with explicit validation and error recovery, and virtually no filler. The two minor weaknesses are a couple of trimmable flourishes and a referenced examples file that is absent from this bundle alongside builder-rule detail that could be split into a reference file.

Suggestions

Add the referenced examples/external-reference.md to the bundle (or drop the pointer and rely on the live catalog-ref.json example path) so the body's reference resolves.

Move the catalog-ref.json builder-enforced rules and the Gotchas detail into a references/ file, keeping SKILL.md as the step-by-step overview.

DimensionReasoningScore

Conciseness

The body is densely packed with non-obvious repo-specific rules and commands and assumes Claude's competence, but has minor trimmable material — the 'catalog is the shelf' metaphor sentence and slight redundancy between Step 1's duplicate-slug note and the Gotchas entry — keeping it just below the lean 'every token earns its place' anchor.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready xc/gh/grep/pnpm commands with flags, an exact catalog-ref.json schema, a frontmatter template, exact file paths, and a precise PR-diff checklist — matching the top anchor.

5 / 5

Workflow Clarity

Clear Step 0–5 sequence with decision branches in FIND (external reference / adaptation / new), explicit validation checkpoints ('validate must report no errors', pnpm test, diff-contents checklist), and error-recovery guidance (rerun build:manifest after changes, gotchas for staleness/duplicates/symlinks) — matching the explicit-validation-with-feedback-loops anchor.

5 / 5

Progressive Disclosure

Good structure with clear step sections and well-signaled one-level references (live catalog-ref.json example, docs guide, prepare-paperclip-pr skill), but 'examples/external-reference.md next to this skill' is not present in the bundle and the catalog-ref builder rules are lengthy inline content that could move to a references/ file — minor organization gaps per the anchor, not the 'content that should be separate is inline' level below.

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 description: it states the full concrete pipeline, gives an explicit 'Use when' clause with natural trigger phrasing, and is tightly scoped to the Paperclip catalog niche. The only gap is a few missing natural synonyms for source material and actions, which keeps trigger term quality just short of the top anchor.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'research prior art, reference or author it, add examples, regenerate the manifest, open a PR' — which comprehensively cover the skill's pipeline, matching the top anchor rather than the 'several specific actions; minor gaps' anchor below it.

5 / 5

Completeness

Explicitly answers both: what ('Turn an idea, tweet, or task into a skill in the Paperclip skills catalog... research prior art... open a PR') and when ('Use when asked to FIND or MAKE a skill and publish it as a bundled/optional catalog skill').

5 / 5

Trigger Term Quality

Good natural-term coverage ('idea, tweet, or task', 'FIND or MAKE a skill', 'bundled/optional', 'publish'), but a few natural phrases users would say are missing (e.g. 'link'/'blog post' as source material, 'add'/'create a skill'), placing it just below the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clearly scoped niche — 'a skill in the Paperclip skills catalog (packages/skills-catalog)' published 'as a bundled/optional catalog skill' — with distinct triggers; minimal overlap risk with generic skill-authoring skills.

5 / 5

Total

19

/

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

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

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.