CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blueprint

Turn a one-line objective into a step-by-step construction plan for multi-session, multi-agent engineering projects. Each step has a self-contained context brief so a fresh agent can execute it cold. Includes adversarial review gate, dependency graph, parallel step detection, anti-pattern catalog, and plan mutation protocol. TRIGGER when: user requests a plan, blueprint, or roadmap for a complex multi-PR task, or describes work that needs multiple sessions. DO NOT TRIGGER when: task is completable in a single PR or fewer than 3 tool calls, or user says "just do it".

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/blueprint/SKILL.md

The canonical home for this skill is blueprint in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The body presents a clear, well-sequenced 5-phase pipeline with concrete examples, but it is undercut by named-but-undefined mechanisms (anti-pattern catalog, review checklist, mutation protocol) and padded installation/security boilerplate. It reads as an effective overview of a skill whose detailed materials were never shipped.

Suggestions

Provide the actual adversarial review checklist and anti-pattern catalog — inline or as references/ files — so the Review phase is executable rather than named.

Specify the plan mutation protocol's split/insert/skip/reorder/abandon operations and their audit-trail format, or move them to a one-level-deep reference file.

Cut the Installation section's generic git-update commands and the 'Zero runtime risk' enumeration down to one line each; Claude already knows how to pin a reviewed commit.

DimensionReasoningScore

Conciseness

The core sections (How It Works, Examples, Key Features) are dense and information-rich, but the Installation section spends ~20 lines on generic git mechanics Claude already knows ('git fetch origin main', 'git log --oneline HEAD..origin/main', 'git checkout <reviewed-full-sha>'), and the 'Zero runtime risk' bullet over-explains ('no hooks, no shell scripts, no executable code, no package.json, no build step...'). Mostly efficient but with some unnecessary explanation that could be trimmed — not 4, where over-explanation would be only minor instances.

3 / 5

Actionability

The 5-phase pipeline is described with real specifics (pre-flight checks, 3–12 one-PR-sized steps, plans/ output with context briefs and exit criteria, executable invocations like '/blueprint myapp "migrate database to PostgreSQL"'), but headline mechanisms — 'a checklist and anti-pattern catalog' and the 'plan mutation protocol' — are named without any content, and no reference files exist for them. Key details are missing, so a fresh agent would have to invent the review checklist; not 4 because these gaps are central rather than minor.

3 / 5

Workflow Clarity

The numbered 5-phase pipeline is a clear sequence with most checkpoints present: pre-flight checks, per-step 'verification commands, and exit criteria', a review gate that 'fixes all critical findings before finalizing' (a feedback loop), and 'invariants verified after every step'. Not 5: the review checklist contents are unspecified and error-recovery detail beyond the review gate is thin; not 3 because validation checkpoints are explicitly woven through the sequence.

4 / 5

Progressive Disclosure

Section headers are clear and nothing is a monolith or nested-reference maze, but the skill's flagship artifacts — anti-pattern catalog, review checklist, and plan mutation protocol — are name-dropped with neither inline content nor reference files anywhere in the bundle (no references/ directory exists). At ~90 lines (above the under-50-line simple-skill exception), the disclosure structure is incomplete; not 4 because the missing detail is more than a minor organization gap for features the skill leads with.

3 / 5

Total

13

/

20

Passed

Description

96%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.

An exemplar description: third-person voice, concrete capability enumeration, explicit positive and negative trigger guidance, and no fluff or over-claims. The only weakness is slight overlap risk between its broad trigger words and general planning requests.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — 'Turn a one-line objective into a step-by-step construction plan', 'self-contained context brief so a fresh agent can execute it cold', and 'adversarial review gate, dependency graph, parallel step detection, anti-pattern catalog, and plan mutation protocol' — comprehensively covering the skill's feature set with no vague filler. Not 4: the enumeration has no coverage gaps relative to what the skill claims to do.

5 / 5

Completeness

Both questions are explicitly answered: the first three sentences state concretely what the skill does, and 'TRIGGER when... DO NOT TRIGGER when...' gives explicit when-to-use guidance with concrete trigger phrases. This matches the anchor-5 example pattern ('what' + 'Use when...' with concrete triggers) exactly; score 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger phrases 'user requests a plan, blueprint, or roadmap for a complex multi-PR task, or describes work that needs multiple sessions' provide comprehensive natural-term coverage including synonyms (plan/blueprint/roadmap) and scenario phrasing, sharpened by a negative trigger ('task is completable in a single PR... or user says "just do it"'). These are words a user would naturally say when needing this skill.

5 / 5

Distinctiveness Conflict Risk

The niche (multi-session, multi-PR construction planning with dependency graphs) is clear and the multi-PR/multi-session qualifiers plus negative triggers mostly disambiguate from generic planning skills. Not 5: the bare trigger words 'plan' and 'roadmap' still carry minor overlap risk with ordinary planning requests that don't involve multiple sessions or PRs.

4 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-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.