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: one-PR-sized steps with self-contained context briefs, dependency graph with parallel-step detection, adversarial review gate, and plan mutation protocol. Use when planning a large feature, refactor, or roadmap that spans multiple PRs or sessions; not for single-PR tasks or when the user says "just do it".

Quality

83%

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

67%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 is a well-organized, concise overview of a 5-phase pipeline with clear sequencing and an explicit review gate, but it functions more as a README than an instruction set: the artifacts that make the skill executable (plan template, context brief format, review checklist, mutation protocol) are named without being provided anywhere in the bundle. Actionability is the main gap.

Suggestions

Include the actual plan-file template and the structure of a step's 'context brief' (or a reference file containing them), so an executing agent has a concrete format instead of only a description of one.

Provide the adversarial review checklist and anti-pattern catalog contents — currently 'against a checklist and anti-pattern catalog' names artifacts that exist nowhere in the skill.

Specify the plan mutation protocol's concrete steps for split/insert/skip/reorder/abandon (including the audit-trail format), rather than only enumerating the operations in a feature bullet.

Trim the Installation section's generic git update instructions to a one-line pointer, since 'git fetch'/'git log'/'git checkout <sha>' workflow is knowledge Claude already has.

DimensionReasoningScore

Conciseness

The body is lean with tight sections and no padding of known concepts, matching the 4 anchor ('efficient; minor instances of over-explanation that could be trimmed'). The Installation section re-explains generic git workflow ('git fetch origin main', 'git log --oneline HEAD..origin/main', pinning to a reviewed SHA) that Claude already knows, which keeps it below the 5 anchor; it is well above the 3 anchor since this is the only over-explained area.

4 / 5

Actionability

The 5-phase pipeline and slash-command examples are concrete, but the core operational detail is missing: the plan-file format, the 'context brief' structure, the review 'checklist and anti-pattern catalog', and the 'plan mutation protocol' are named but never specified, and no bundle files exist to hold them. This matches the 3 anchor ('some concrete guidance but incomplete... missing key details') rather than the 4 anchor, where the guidance is mostly executable.

3 / 5

Workflow Clarity

The numbered 5-phase pipeline is a clear sequence with an explicit validation checkpoint ('Fixes all critical findings before finalizing') and per-step 'verification commands, and exit criteria', matching the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps'). It falls short of the 5 anchor because there are no concrete feedback-loop or error-recovery procedures for the review or mutation phases.

4 / 5

Progressive Disclosure

A single well-sectioned file (When to Use, How It Works, Examples, Key Features, Installation, Requirements) with appropriate overview content, matching the 4 anchor ('good structure; most content is appropriately placed; minor organization gaps'). It is not the 5 anchor because the substantial material the body promises (checklist, anti-pattern catalog, mutation protocols, plan template) has no home at all — neither inline nor in one-level-deep reference files.

4 / 5

Total

15

/

20

Passed

Description

92%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 capability list, explicit use-when guidance with natural trigger phrases, and negative scoping that sharpens distinctiveness. The only gap is a few missing synonyms (e.g., 'break down', 'migration') that would widen trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'one-PR-sized steps with self-contained context briefs, dependency graph with parallel-step detection, adversarial review gate, and plan mutation protocol' — giving comprehensive coverage of the skill's capabilities. It clearly matches the 5 anchor ('multiple specific concrete actions; comprehensive coverage') and is not the 4 anchor because no meaningful capability gap remains.

5 / 5

Completeness

It explicitly answers both what (construction plan with dependency graph, review gate, mutation protocol) and when ('Use when planning a large feature, refactor, or roadmap that spans multiple PRs or sessions'), with concrete trigger phrases plus explicit negative scoping ('not for single-PR tasks or when the user says "just do it"'). This fully matches the 5 anchor and exceeds the 4 anchor, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Natural phrases like 'planning a large feature', 'refactor', 'roadmap', 'spans multiple PRs or sessions' are what users would actually say, matching the 4 anchor's 'good keyword coverage; a few natural terms missing'. It falls short of 5 because common variations such as 'break down a project', 'migration', or 'epic' are absent.

4 / 5

Distinctiveness Conflict Risk

The multi-session/multi-PR planning niche is distinct, and the negative triggers ('not for single-PR tasks') further reduce mis-triggering against generic planning or single-task skills, matching the 5 anchor's 'clear niche with distinct triggers; minimal conflict risk'. It is not the 4 anchor because there is no meaningful overlap with closely related skills left unstated.

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

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.