CtrlK
BlogDocsLog inGet started
Tessl Logo

paperclip-converting-plans-to-tasks

Convert Paperclip plans into executable issue graphs. Use when asked to plan, scope, or break down Paperclip company work into assigned tasks with specialty fit, dependencies, blockers, and parallelization.

72

Quality

88%

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

92%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 instruction-only skill: concrete, executable policy with explicit validation and feedback loops in the conversion workflow, and clean single-file organization. The only notable weakness is mild redundancy — the closing checklist and 'What this skill is not' section restate points already made.

Suggestions

Trim the 'Quick checklist' to items that add checks beyond the body text (e.g., keep the matrix/verification items) or fold the recap into the conversion workflow section to cut ~8 lines of duplication.

Compress 'What this skill is not' to a single line or merge it into the intro, since the opening paragraph already states the skill does not dictate plan structure.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious domain policy (qualifying boundaries, reviewer 403 boundary, auto-wake semantics) and never explains concepts Claude already knows. However, the 'Quick checklist' section (12 items) largely restates the rules above it, and 'What this skill is not' repeats the intro's 'does not dictate a plan structure' point — minor trimmable redundancy that keeps it below the lean 5 anchor.

4 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: 'Wire every hard dependency between issues through `blockedByIssueIds`', 'leave the planning issue in `in_review` or `blocked`', 'post findings on **their own review issue** and mark it `done`', and 'write a compact task matrix with each proposed task, owner, initial status, blockers, and the specific qualifying reason'. Specific fields, statuses, and procedures cover the common cases.

5 / 5

Workflow Clarity

The conversion workflow is a clear sequence (one end-to-end task → task matrix → merge-back pass → create → re-fetch and verify) with an explicit validation checkpoint ('re-fetch the created issues or otherwise verify the issue graph before marking the source planning issue done') and a feedback loop on failure ('correct it or report the mismatch and leave the planning issue in `in_review` or `blocked`'), plus a pre-publish checklist. The batch graph-creation context includes validation, so no cap applies.

5 / 5

Progressive Disclosure

A single well-organized SKILL.md (~52 lines) with clear sections and no bundle files needed; no references/, scripts/, or assets/ exist. Its one external pointer ('follow the _Planning_ section of the `paperclip` skill') is clearly signaled and one level deep, matching the simple-skill guidance that a well-organized single file with no needed external references scores 5.

5 / 5

Total

19

/

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 description: third-person voice, explicit 'Use when' trigger clause, and a clearly scoped Paperclip niche. The main gaps are a single-action framing (rather than enumerating several capabilities) and minor trigger overlap with the parent `paperclip` skill's planning guidance.

DimensionReasoningScore

Specificity

The description names a concrete action ('Convert Paperclip plans into executable issue graphs') and specific deliverable attributes ('assigned tasks with specialty fit, dependencies, blockers, and parallelization'), but only one core action is listed rather than several. It sits above the '1-2 concrete actions, not comprehensive' anchor (3) because the output dimensions are concrete, and below 5 because coverage is not comprehensive (e.g., verification/merge-back pass is not mentioned).

4 / 5

Completeness

It explicitly answers both: what ('Convert Paperclip plans into executable issue graphs. Use when asked to plan, scope, or break down Paperclip company work into assigned tasks') and when ('Use when asked to plan, scope, or break down...'). Both are stated with concrete trigger phrases, matching the 5 anchor exactly; not below 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

'Use when asked to plan, scope, or break down' plus 'tasks', 'dependencies', 'blockers', 'parallelization' are natural phrases a user would say. Good keyword coverage with a few natural variants missing (e.g., 'decompose', 'split work', 'assign tasks' as an explicit trigger), so it fits the 4 anchor rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Paperclip plans', 'Paperclip company work', and 'issue graphs' carve out a clear niche, but 'Use when asked to plan' overlaps with the companion `paperclip` skill's own planning triggers — minor overlap risk with a closely related skill. It is above 3 because the domain vocabulary is distinctive, below 5 because of the companion-skill trigger overlap.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.