CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blueprint

Plan a non-trivial code change rigorously — understand the problem, form a hypothesis, validate assumptions through real experiments and doc/code reads, and cross-check the proposed solution against product specs, architecture, and the existing codebase before writing any plan. Use when the user says "/blueprint", "blueprint this", "plan this thoroughly", "deep plan", "I want to be sure before we build this", or for any change where a wrong direction would burn meaningful time, tokens, or compute. Heavier and more deliberate than `/plan`; the goal is the global optimum, not a local one.

Quality

94%

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

96%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 exceptionally well-crafted process skill: lean, jargon-free, with a 10-step workflow that bakes validation and feedback loops into every phase and delegates detail to clearly-signaled, real reference files at exactly the right steps. The single blemish is that two of the six referenced resources live outside the skill directory and cannot be verified from the bundle.

Suggestions

Make the out-of-bundle resources verifiable: either co-locate `writing.md` and `prose-lint.py` under the skill's own directory, or state in the references table what to do when they are absent (e.g., 'if missing, apply the rules from memory') so step 9 never dead-ends.

Add one line to the references table describing what `prose-lint.py` checks, so a reader can judge whether the lint output is fully addressed without opening the script.

DimensionReasoningScore

Conciseness

The ~60-line body is lean with no re-teaching of concepts Claude already knows; even the framing lines ("A cheap experiment beats confident reasoning, and the source on `HEAD` beats memory") are compact behavioral rules, not padding. Every token earns its place, matching the 'lean and efficient; assumes Claude's competence' anchor rather than the score-4 anchor's 'minor instances of over-explanation'.

5 / 5

Actionability

Per the instruction-only scoring note, guidance is thoroughly concrete: each step names its object and success criterion ("Classify each as Verified, Plausible, or Risky"; every command/tool/port "comes from a `file:line` in the repo, never from training data"; "Run `<plugin root>/scripts/prose-lint.py` on it"; "After about three rounds, surface that the problem needs reframing"), and the exact reference file to read is pinned to each step. There are no missing key details for a process skill of this genre, so it sits at the 'fully actionable' anchor rather than 'minor gaps'.

5 / 5

Workflow Clarity

Ten numbered steps are clearly sequenced with explicit validation checkpoints and feedback loops: "A refuted assumption sends you back to step 2. Never patch around it", the loop-or-commit rule with a three-round reframing trigger at step 8, an evidence-based Definition of done that "sends you back to the step that produces it", and a gated step 10 requiring explicit approval for deviations. This matches the 'explicit validation steps; feedback loops for error recovery' anchor; score 4's 'minor validation gaps' does not apply. No destructive/batch-operation cap applies to a planning skill.

5 / 5

Progressive Disclosure

The 'Required references' table (File / Read at / Holds) is exemplary one-level-deep navigation — better-signaled than the score-5 example — and all four `references/*.md` files exist and match their stated contents. However, two referenced paths (`../../assets/writing.md` and `<plugin root>/scripts/prose-lint.py`) do not resolve within the skill's bundle, so scored against the actual file listing plus referenced paths this is 'good structure ... minor organization gaps' rather than fully clean navigation.

4 / 5

Total

19

/

20

Passed

Description

88%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: concrete, comprehensive capability statements paired with an explicit and natural 'Use when' trigger clause, in third-person imperative voice with no fluff. The only weaknesses are a handful of missing natural trigger synonyms and minor trigger overlap with a generic `/plan` skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "understand the problem, form a hypothesis, validate assumptions through real experiments and doc/code reads, and cross-check the proposed solution against product specs, architecture, and the existing codebase" — comprehensively covering the planning workflow with no vague filler. It clearly matches the 'multiple specific concrete actions; comprehensive coverage' anchor rather than the score-4 anchor, which tolerates coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the full validate-then-plan pipeline, and the "when" is a concrete "Use when the user says ..." clause listing real trigger phrases plus a situational condition. This is a clear match for the 'clearly and explicitly answers both what AND when with concrete trigger phrases' anchor; the score-4 anchor's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Trigger phrases are natural and varied across registers ("/blueprint", "blueprint this", "plan this thoroughly", "deep plan", "I want to be sure before we build this", "a wrong direction would burn meaningful time, tokens, or compute"), but common variants like "design this", "spec this out", or "research before building" are absent. This lands between the 'good keyword coverage; a few natural terms missing' (4) anchor and comprehensive (5), and is noticeably above the midpoint of that gap.

4 / 5

Distinctiveness Conflict Risk

The closing line "Heavier and more deliberate than `/plan`; the goal is the global optimum, not a local one" explicitly differentiates it from the nearest competing skill. However, triggers like "plan this thoroughly" and "deep plan" could plausibly also invoke a lighter planning skill, so it is 'mostly distinct; minor overlap risk with closely related skills' rather than a fully conflict-free niche.

4 / 5

Total

18

/

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

korya/swd-skills

Path

skills/blueprint/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.