CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

speckit-plan

Execute the implementation planning workflow using the plan template to generate design artifacts.

52

Quality

65%

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 ./.claude/skills/speckit-plan/SKILL.md
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-sequenced, largely executable workflow with real validation checkpoints (gates, constitution checks, prerequisites) and concrete commands, paths, and output templates. Its main weaknesses are the verbatim duplication of the extension-hook procedure and one underspecified step ('the agent script'), which cost tokens and leave a small execution gap.

Suggestions

Factor the extension-hook procedure (enabled filtering, condition policy, dot-to-hyphen conversion, output templates) into a single shared block referenced by both the pre-execution check and Outline step 5, cutting ~25 duplicated lines.

Name the exact agent-context script and command in Phase 1 ('Update the plan reference... by running the agent script') so the step is executable as written.

Specify what to do when setup-plan.sh fails or its JSON cannot be parsed, mirroring the silent-skip guidance already given for invalid extensions.yml.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no tutoring of known concepts, but the ~28-line extension-hook procedure (enabled filtering, condition handling, dot-to-hyphen command conversion, output templates) is duplicated verbatim for before_plan and after_plan. That matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — not 2, since the redundancy is the only notable padding and the remainder is lean; not 4, because the duplication is a real, avoidable token cost that a single shared procedure would eliminate.

3 / 5

Actionability

Most steps are concrete and executable: the exact command '.specify/scripts/bash/setup-plan.sh --json', specific paths (.specify/memory/constitution.md, CLAUDE.md SPECKIT markers), a shell-quoting escape example, and exact output templates for each hook type. It falls short of 5 because 'Update agent context by running the agent script' never names the script or command, and the plan workflow defers to an external IMPL_PLAN template whose structure is not reproduced — minor gaps that keep it from copy-paste readiness throughout.

4 / 5

Workflow Clarity

The sequence is explicit (Setup → Load context → Execute plan workflow → Stop and report → post-hooks), phases carry prerequisites ('research.md complete'), and validation checkpoints exist: gate evaluation with 'ERROR if violations unjustified', NEEDS CLARIFICATION markers resolved in Phase 0, and a post-design Constitution Check re-evaluation. Not 5 because there is no recovery loop for gate failures beyond 'ERROR', and failure handling for the setup script/JSON parse is unspecified; comfortably above 3, which requires missing or merely implicit checkpoints.

4 / 5

Progressive Disclosure

The body is well-sectioned (User Input, Pre-Execution Checks, Outline, Phases, Key rules) at ~135 lines with no bundle files, and it appropriately defers bulk detail (the plan structure) to the project's own IMPL_PLAN template rather than inlining it. This matches 'Good structure; most content is appropriately placed; minor organization gaps' — the minor gap being the duplicated hook boilerplate living inline. Not 5 because the file exceeds a lean overview and the repeated hook block would sit better in a shared reference section.

4 / 5

Total

15

/

20

Passed

Description

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

The description gives a clear, concise statement of what the skill does, but stops there. It names no concrete deliverables, includes no usage triggers, and omits the spec-kit vocabulary that would both sharpen matching and distinguish it from generic planning skills.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to plan a feature, create an implementation plan, or run /speckit-plan in a spec-kit project.'

Name the concrete artifacts the workflow generates (research.md, data-model.md, contracts, quickstart.md) instead of the generic 'design artifacts'.

Include the natural trigger terms users of this tool would say — 'spec-kit', 'speckit', 'feature spec', 'implementation plan' — to improve matching and distinctiveness.

DimensionReasoningScore

Specificity

The description states the domain ('implementation planning workflow') and two actions ('Execute... using the plan template to generate design artifacts'), but 'design artifacts' is generic and never names what is actually produced (research.md, data-model.md, contracts, quickstart.md). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — not 4, which requires several specific listed actions, and not 2, since it goes beyond merely naming the domain.

3 / 5

Completeness

The 'what' is clear ('Execute the implementation planning workflow... to generate design artifacts') but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the when-condition is not merely implicit-and-improvable, it is missing altogether.

3 / 5

Trigger Term Quality

Terms like 'implementation planning', 'plan template', and 'design artifacts' are relevant, but the natural phrases a user would say — 'spec-kit', 'speckit', 'feature spec', 'implementation plan', 'specify' — are absent, and no synonyms or 'Use when' phrasing appears. This fits 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'good keyword coverage with only a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

'Implementation planning workflow' is somewhat specific and unlikely to collide with unrelated skills, but without mentioning spec-kit, feature specs, or .specify, it could overlap with generic planning/design skills. This matches 'Somewhat specific but could still overlap with similar skills' rather than 4's 'mostly distinct with only minor overlap risk against closely related skills'.

3 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

g14wx/staffSync

Path

.claude/skills/speckit-plan/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.