CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

85%

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

81%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 with explicit validation and governance feedback loops and a properly split reference bundle. The weakest area is conciseness: the runner-selection section carries rot-prone platform/version detail in dense prose, and reference paths use two inconsistent styles.

Suggestions

Move the platform/version-sensitive runner details (OS/arch support matrix, 'claude-opus-5-5', glibc requirements) into the api-reference or a dedicated runner-selection reference file, keeping only the decision rule ('runner accepts auto, paperclip, or legacy; use legacy when CLI settings must be honored') in SKILL.md.

Standardize reference paths to bundle-relative markdown links like the ones in step 4 (e.g. [draft-review checklist](references/draft-review-checklist.md)) instead of mixing 'skills/paperclip-create-agent/references/...' installation paths in step 7 and the References section.

Break the long policy sentences in Preconditions and step 4 into short imperative bullets (condition, action, rationale) so each rule is scannable without re-reading.

DimensionReasoningScore

Conciseness

The body is mostly efficient and imperative with no padding of known concepts, but the 'Harness and runner selection' section embeds time-sensitive platform and version enumerations ('Apple Silicon, Intel Mac, Linux x64 and Linux ARM64 with supported glibc', 'claude-opus-5-5') in dense prose outside any deprecated/old-patterns section, and long policy sentences (Preconditions, step 4) could be tightened, matching the 'mostly efficient but could be tightened' anchor 3.

3 / 5

Actionability

Fully executable, copy-paste-ready curl commands for every API step, a complete JSON POST payload for the hire request, field-level specifics ('runtimeConfig.heartbeat.enabled', 'instructionsBundle.files["AGENTS.md"]', 'resolverPolicy: "human_only"'), and explicit fallback actions when tools are unavailable, matching the anchor-5 example of concrete commands covering the common cases.

5 / 5

Workflow Clarity

A clear nine-step sequence with an explicit pre-submit validation checkpoint and fix loop ('walk the draft-review checklist end-to-end and fix any item that does not pass'), governance feedback loops (monitor the approval thread, wake on PAPERCLIP_APPROVAL_ID, close/comment linked issues), and a defined denial-handling path — matching the anchor-5 pattern of validation steps, feedback loops, and a checklist; the operation is a creation flow, not destructive/batch, so no cap applies.

5 / 5

Progressive Disclosure

The body is a readable overview with five real, one-level-deep reference files (verified present: agent-instruction-templates.md, baseline-role-guide.md, draft-review-checklist.md, api-reference.md, plus per-role templates under references/agents/) and clear pointers in a References section; the gap is path inconsistency — step 4 uses proper relative markdown links while step 7 and the References section use 'skills/paperclip-create-agent/references/...' installation paths, so it sits at 'good structure, minor organization gaps' rather than the fully clean navigation of 5.

4 / 5

Total

17

/

20

Passed

Description

83%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 with explicit what-and-when coverage and a clearly distinct Paperclip niche. Its only deductions are the second-person trigger phrasing (penalized on specificity per the rubric) and missing natural synonyms in the trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hire request'), matching the comprehensive anchor 5, but the second-person trigger phrasing 'Use when you need to...' incurs the rubric's mandatory 1-point penalty on specificity, lowering it to 4.

4 / 5

Completeness

It 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') with concrete trigger activities, matching the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Good natural-keyword coverage ('create new agents', 'hire', 'agent configs', 'adapter configuration'), but common variations a user might actually say (e.g. 'add/onboard an agent', 'recruit', 'new teammate') are missing, so it fits anchor 4 rather than the comprehensive synonym coverage of 5 and clearly above the partial coverage of 3.

4 / 5

Distinctiveness Conflict Risk

'Paperclip' and 'governance-aware hiring' carve a clear niche with distinct triggers, but the 'use when' clause itself does not name Paperclip and terms like 'create agents' mildly overlap with generic agent/subagent-creation skills, placing it at 'mostly distinct; minor overlap risk' rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

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

Path

skills/paperclip-create-agent/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.