CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spek-plan

Create a new Plan from an approved Specification.

Quality

67%

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/spek-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong operational skill body: it gives exact, executable commands for every branch of a complex stateful workflow, with real validation checkpoints and error-recovery paths. Its main weakness is repetition of the same do-not-stop-early warning, which inflates length without adding information.

DimensionReasoningScore

Conciseness

Nearly all content is skill-specific operational knowledge Claude cannot know (CLI commands, resume semantics, working-file layout), but the core warning 'do not stop after plan new' is repeated three times — the STOP blockquote, the 'This is a loop' section, and the 'Concretely' paragraph — and the version-check preamble is similarly heavy. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Every instruction is copy-paste executable: exact commands with full JSON payloads ('spektacular plan new --data '{"name": "<spec_name>"}''', 'spektacular design ref list --data ...'), exact file paths (.spektacular/work/<plan_name>/<section>.md, .spektacular/tmp/), and precise placeholder conventions. This fully matches anchor 5 (fully executable, copy-paste ready commands covering the common cases).

5 / 5

Workflow Clarity

The workflow is explicitly sequenced (version check → spec selection → plan new → instruction/goto loop → walkthrough → finished) with genuine validation gates and feedback loops: the mandatory version check before anything else, the uncommitted-changes and auto_commit_failed question/error handling, the verification step over staged documents, broken design references that stop and report rather than plan around the gap, and the mandatory user sign-off before 'finished'. This matches anchor 5 (clear sequence with explicit validation steps and feedback loops for error recovery).

5 / 5

Progressive Disclosure

The body is well-structured with clear top-level sections (version check, tracing, what the skill does, file I/O, design refs, decisions, working files, how to start, orchestrator mode) and no nested or buried references — appropriate for a standalone skill with no bundle files. It does not reach anchor 5 because sections like the orchestrator-mode rules and the detailed resume procedure are inline content that could arguably live in a separate reference file, leaving minor organization gaps per anchor 4.

4 / 5

Total

17

/

20

Passed

Description

37%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 is a terse, grammatically clean 'what' statement, but it stops there: no use-when triggers, no concrete deliverables, and no distinctive keywords. A user or model scanning skill descriptions would have little to distinguish it from generic planning helpers or know when to invoke it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to plan an approved spec, create an implementation plan, or run the spektacular plan workflow.'

Enumerate the concrete outputs (the assembled plan.md, the plan's context.md, and research.md) so the 'what' goes beyond one generic verb.

Include distinctive ecosystem terms users would actually say — 'spektacular', 'implementation plan', 'spec' — to reduce overlap with generic planning skills.

DimensionReasoningScore

Specificity

The phrase 'Create a new Plan' names the domain (spec-to-plan planning) but describes only one minimal action; it never mentions the concrete artifacts the skill actually produces (plan.md, context.md, research.md) or the multi-step workflow it drives. This matches anchor 2 ('Names the domain but actions are minimal or generic') and is below anchor 3, which expects 1-2 concrete actions beyond the domain name.

2 / 5

Completeness

It clearly answers 'what' (create a plan from an approved spec) 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. It is not a 4 because the 'when' is not merely implicit-and-improvable; it is simply missing.

3 / 5

Trigger Term Quality

The only keywords are 'Plan' and 'Specification' — one or two generic terms with no natural phrases a user would say ('write an implementation plan', 'plan this spec', 'spektacular') and no synonyms or variations. It sits between anchor 2 ('one or two generic keywords; missing the natural phrases users say') and anchor 3, closer to 2 because even the terms present are abstract nouns rather than user-facing triggers.

2 / 5

Distinctiveness Conflict Risk

'Create a new Plan from an approved Specification' is somewhat specific (it implies a spec-driven pipeline) but 'plan' and 'spec' are generic words that would overlap with any general planning, roadmap, or spec-implementation skill. It does not reach anchor 4 because the description carries no distinctive trigger terms (e.g. 'spektacular', 'implementation plan') that would separate it from generic planning skills.

3 / 5

Total

10

/

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

nicholasjackson/tcgreplay

Path

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