CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-workflow

Use when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.

59

Quality

74%

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 ./config/source/skills/spec-workflow/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.

A well-structured process skill with a clearly sequenced four-phase workflow, explicit confirmation gates, and concrete templates (EARS pattern, task format, output paths). Its main weakness is redundancy: three separate sections repeat the same use/skip decision rule, which inflates token cost without adding information.

Suggestions

Merge 'Activation Contract' (Use this first when / Do NOT use for / Minimal checklist), 'When to use this skill', and 'Decision rule' into a single decision section — they restate the same criteria three times.

Add a verification step in Phase 4, e.g., 'Before finishing, check every tasks.md item links to a requirement and all acceptance criteria are demonstrably met'.

Include a brief worked example of requirements.md output so Phase 1 guidance matches the concreteness of the EARS and task templates.

DimensionReasoningScore

Conciseness

Individual sections are lean and free of concept-explaining fluff, but the same use/skip decision is stated three times ('Activation Contract' with its checklist and 'Do NOT use for', 'When to use this skill', and 'Decision rule'), which is substantial redundant padding that could be merged into one section. This places it between 'noticeably verbose with padded sections' (2) and 'mostly efficient' (3) — the text itself is efficient, so 3 fits best, though consolidation would recover a full section.

3 / 5

Actionability

Concrete, copy-paste-ready templates are provided: the EARS pattern ('While <optional precondition>, when <optional trigger>, the <system name> shall <system response>') with a worked example, the task-format markdown template, and exact output paths (specs/<spec_name>/requirements.md, design.md, tasks.md). Not level 5 because Phases 1-2 'What to do' bullets are directives without a worked example (e.g., no sample requirements.md or design.md structure).

4 / 5

Workflow Clarity

The four-phase sequence (Requirements -> Design -> Tasks -> Execution) is clearly ordered with explicit user-confirmation checkpoints ('Require confirmation between requirements, design, and task breakdown', 'Only start implementation after the user confirms the task plan'). This is a planning workflow, not a destructive/batch operation, so the validation cap does not apply; it falls short of level 5 only because Phase 4 lacks verification steps (e.g., checking every task links back to a requirement).

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, assets/), and all content is inline with clear section headers; the sibling-skill pointers (../ui-design/SKILL.md, ../data-model-creation/SKILL.md) are one level deep and clearly signaled. The ~150-line body is appropriately self-contained for a process skill, so per the rubric's bundle-structure guideline this is well-organized inline content with minor organization gaps (the duplicated decision sections), matching the level-4 anchor rather than the under-50-line simple-skill exception.

4 / 5

Total

15

/

20

Passed

Description

70%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, trigger-oriented description with a clear 'Use when' clause and good natural keywords for spec-driven development. Its main weakness is that the 'what' is implied through the when-clause rather than stated as concrete actions or artifacts. Not first/second person, no fluff or over-claims.

Suggestions

State the 'what' explicitly with concrete artifacts, e.g., 'Create specs/<name>/requirements.md, design.md, and tasks.md with EARS acceptance criteria' before the 'Use when' clause.

Add common synonyms users would naturally say, such as 'spec', 'new feature', 'multi-module refactor', or 'PRD', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain and the three planning activities ("explicit requirements, technical design, and task planning"), but these are stated as needs ("changes need...") rather than concrete actions the skill performs, and no concrete outputs (e.g., requirements.md, design.md, tasks.md) are named. It matches 'names domain and 1-2 concrete actions, but not comprehensive' more than the level-4 anchor, which expects an explicit list of specific actions with only minor coverage gaps.

3 / 5

Completeness

It has an explicit 'Use when...' trigger clause, satisfying the rubric's cap rule, and the 'what' is inferable (requirements, design, and task planning) but is embedded in the 'when' clause rather than stated as an explicit capability (e.g., 'Create requirements, design, and task-plan documents'). Both are present with one imperfect — matching the level-4 anchor rather than the fully explicit level-5 anchor.

4 / 5

Trigger Term Quality

Terms like "requirements", "technical design", "task planning", "multi-module work", "unclear acceptance criteria", and "architecture-heavy requests" are natural phrases a user would say when they need this skill. A few common synonyms are missing (e.g., "spec", "feature", "refactor", "PRD"), so it does not reach the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The spec-driven development niche (requirements -> design -> tasks before implementation) is fairly distinct with targeted triggers, but it could overlap with generic planning or project-management skills for phrases like 'task planning' or 'architecture'. Minor overlap risk with closely related skills matches the level-4 anchor.

4 / 5

Total

15

/

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

TencentCloudBase/CloudBase-AI-Toolkit

Path

config/source/skills/spec-workflow/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.