CtrlK
BlogDocsLog inGet started
Tessl Logo

paperclip-create-agent

Create new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hire request.

71

Quality

88%

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.

A well-structured operational skill: a clearly sequenced 9-step workflow with an explicit pre-submit checklist validation loop, copy-paste curl commands and a complete hire payload, and thoughtful handling of both governance denial and post-approval states. The main weaknesses are mild verbosity in the governance prose and inconsistent reference path styling.

DimensionReasoningScore

Conciseness

No padding of concepts Claude already knows, and the curl blocks and payload example are lean. The Preconditions and transport sections are dense but contain non-obvious policy; however, some long sentences ('Preserve the proposed hire in the conversation; do not claim an agent was created or substitute a temporary subagent...') could be tightened. Not 3 because almost all content is non-obvious operational policy; not 5 because the governance prose is wordy in places.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste curl commands using $PAPERCLIP_API_URL/$PAPERCLIP_API_KEY, a complete JSON hire payload with realistic field values, named Runner tools (get_task_context, list_agents, search_api, call_api), and a complete approval-comment example. Not 4 because the common cases are covered end-to-end with no gaps.

5 / 5

Workflow Clarity

Nine clearly sequenced steps with an explicit pre-submit validation loop ('walk the draft-review checklist end-to-end and fix any item that does not pass'), governance-state handling with a post-approval follow-up loop, and a denial path in Preconditions with concrete fallback actions. This matches the anchor: explicit validation steps, feedback loops, and a checklist for a complex process.

5 / 5

Progressive Disclosure

All five referenced files exist and are one level deep, with a labeled References section and inline links in step 4. Minor gaps: path styles are inconsistent (relative markdown links in step 4 vs. bare 'skills/paperclip-create-agent/references/...' paths in step 7 and the References list), and api-reference.md is only listed at the bottom rather than signaled at the payload-drafting steps where it is most relevant. Not 3 because structure and signaling are otherwise good; not 5 because of these organization gaps.

4 / 5

Total

18

/

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 that names the platform, the domain, and four concrete workflow actions, with an explicit 'Use when' trigger clause. Minor gaps: the approval/governance follow-up work is only hinted at by 'governance-aware hiring', a few natural synonyms are missing, and the trigger clause uses second person.

DimensionReasoningScore

Specificity

Lists four concrete actions ('inspect adapter configuration options', 'compare existing agent configs', 'draft a new agent prompt/config', 'submit a hire request'), but approval/governance handling is not listed as an action and the trigger clause uses second person ('Use when you need to'), which the guidelines penalize by one point. Not 3 because it far exceeds 1-2 actions; not 5 because of the coverage gap and the voice penalty.

4 / 5

Completeness

Explicitly answers both: what ('Create new agents in Paperclip with governance-aware hiring') and when ('Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hire request'). The 'Use when...' clause with concrete triggers matches the anchor-5 example pattern; not 4 because the 'when' is fully explicit and specific.

5 / 5

Trigger Term Quality

Good keyword coverage with the natural synonym pair 'create new agents'/'hire request' plus 'agent configs' and 'adapter configuration'. Not 5 because common variations like 'onboard', 'add a new agent', or 'add a team member' are missing; not 3 because the main synonyms users would say are present.

4 / 5

Distinctiveness Conflict Risk

'Paperclip' plus agent hiring is a clear niche with distinct triggers (create/hire an agent, submit a hire request); minimal conflict risk with other skills. Not 4 because no meaningful overlap with adjacent skills is evident from the description.

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

relative_links

Relative link issues: 3 suspicious

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.