CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

speckit-checklist

Generate custom quality checklists for validating requirements completeness and clarity. Use to create unit tests for English that ensure spec quality before implementation.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./bundled/skills/speckit-checklist/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 thorough, well-structured instruction-only skill with a clear sequenced workflow, strong executable guidance, and effective anti-example contrasts that reinforce the core 'test requirements, not implementation' principle. Its main weakness is conciseness: examples and wrong-vs-correct patterns are repeated across multiple sections, inflating the token budget without proportional value.

Suggestions

Consolidate the repeated wrong-vs-correct examples: the 'prominent display', 'hover state', and logo examples appear in the Purpose, Generation, and Anti-Examples sections — keep one canonical set and cross-reference it to cut ~40-60 lines.

Move the per-domain sample item catalogs (UX/API/Performance/Security) into a separate reference file (e.g. references/checklist-examples.md) and link to it from the body, improving both conciseness and progressive disclosure.

Add one complete sample checklist file (with title, meta, and a few CHK### items across categories) so Claude has a fully copy-paste-ready template rather than assembling it from scattered fragments.

DimensionReasoningScore

Conciseness

The body is mostly efficient and well-organized, but it is noticeably long (~300 lines) with repeated content: the 'prominent display'/'hover state' examples and the wrong-vs-correct patterns recur across the Purpose, Generation, Examples, and Anti-Examples sections, which could be consolidated.

3 / 5

Actionability

Provides concrete, executable guidance: a specific setup command, exact file paths, a filename convention, item numbering rules, bracket markers, and many copy-ready example items; minor gaps remain because no complete end-to-end sample checklist file is shown in full.

4 / 5

Workflow Clarity

The 7-step sequence is clearly numbered and ordered with explicit validation-adjacent checkpoints (parse JSON, skip ambiguous questions, soft cap, ≥80% traceability rule), and the create-if-not-exists / never-overwrite rule prevents destructive clobbering; a fully explicit validate-then-fix feedback loop for the checklist output itself is not spelled out, keeping it just below 5.

4 / 5

Progressive Disclosure

Good structural organization with clear section headers and one-level-deep references to external files (check-prerequisites.ps1, .specify/templates/checklist-template.md, FEATURE_DIR/spec.md|plan.md|tasks.md); no nested multi-level reference chains, though much of the example catalog (UX/API/Performance/Security sample items) could arguably live in a separate reference file rather than inline.

4 / 5

Total

15

/

20

Passed

Description

66%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 solid, mostly third-person description that clearly conveys both what the skill does and when to use it, with concrete actions and a reasonably distinct niche. Its main weakness is trigger-term coverage: the memorable but non-natural phrase 'unit tests for English' and missing common synonyms reduce the chance of triggering on real user phrasings.

Suggestions

Add a more explicit 'Use when...' clause listing natural user phrases a user would actually say, e.g. 'Use when the user asks to review a spec, check requirements completeness, or build a requirements checklist before implementation.'

Round out trigger-term coverage with common synonyms like 'spec review', 'requirements checklist', and 'spec validation' rather than relying on the coined 'unit tests for English' phrase.

Tighten the description to a single concise sentence for the 'what' followed by a concrete 'Use when...' sentence, avoiding the slightly padded 'completeness and clarity' enumeration.

DimensionReasoningScore

Specificity

Lists several specific concrete actions ('Generate custom quality checklists', 'validating requirements completeness and clarity', 'create unit tests for English', 'ensure spec quality before implementation') with only minor coverage gaps around which spec formats or domains are supported.

4 / 5

Completeness

Provides a clear 'what' (generate custom quality checklists for validating requirements completeness and clarity) and an explicit 'when' ('Use to create unit tests for English that ensure spec quality before implementation'); the trigger could be more concrete with specific user phrasings, which keeps it just below a 5.

4 / 5

Trigger Term Quality

Includes relevant keywords like 'quality checklists', 'requirements completeness', 'spec quality', and 'unit tests for English', but misses common natural variations users might say ('checklist', 'spec review', 'requirements review') and file/extension triggers; the coined phrase 'unit tests for English' is evocative but not something a user would naturally utter.

3 / 5

Distinctiveness Conflict Risk

The 'requirements/spec quality' niche is fairly distinct from general testing or documentation skills, and the 'before implementation' timing cue narrows it further; minor overlap risk remains with broader spec-review or testing skills.

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

foryourhealth111-pixel/Vibe-Skills

Path

bundled/skills/speckit-checklist/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.