CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-review

Review a spec in this repo against the SpecTrace corpus of org standards, decisions, and commitments. Runs `spectrace corpus review` and formats what it emits. Use when the user asks to review a spec against the corpus, check which standards a spec touches, find unaddressed obligations or stale citations, or says "corpus review this", "which standards apply to this spec", "is this spec covered".

78

Quality

98%

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

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

An exceptionally disciplined operational skill: exact commands, verbatim-quote rules, explicit error handling, and a fully specified output format with a worked example. The only structural weakness is that everything lives inline in one file with references pointing at repo docs outside the bundle.

Suggestions

Move the detailed output-format specification (the worked reviewer-checklist example and the findings table layout) into a references/output-format.md file, keeping SKILL.md as a lean overview with a clearly signaled link.

Move the finding-to-fix table into a reference file (e.g., references/fixes.md) and link it from a one-line pointer, so the run-time instructions stay lean.

Clarify that `docs/corpus-review.md` and `docs/corpus-authoring.md` live in the corpus repo rather than the skill bundle, or bundle copies of the needed material under references/ so the skill is self-contained.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout ('Add no finding the tool did not emit', 'Quote the entry body verbatim', 'Report the exit code and the error verbatim') with zero concept padding. The long reviewer-checklist example is a concrete output template, not filler, so every token earns its place — matching the 5 anchor rather than the 4 anchor's 'minor instances of over-explanation'.

5 / 5

Actionability

Fully executable guidance: exact commands with flags (`spectrace corpus review <spec-path> --format json`), exit-code semantics, two verbatim error strings with their meanings, exact output table column headers, a `grep -rl` lookup for corpus files, a worked checklist example, and a per-finding fix table. This meets the 5 anchor's 'copy-paste ready commands covering the common cases'.

5 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with JSON as the declared source of truth, and step 4 is an explicit validation checkpoint ('Every finding in the JSON appears in your output. Nothing else does.'). Error recovery is explicit ('print the error verbatim and stop') with the UnknownCitationError-vs-orphan_citation distinction spelled out. This is a read-only review skill, so the destructive/batch validation cap does not apply; the sequence matches the 5 anchor's explicit checkpoints and error-feedback handling.

5 / 5

Progressive Disclosure

Sections are well-organized and the Reference section clearly signals one-level-deep docs with one-line descriptions, matching the 4 anchor's 'good structure; references mostly clear; minor organization gaps'. It falls short of the 5 anchor because the skill is a single 145-line inline body (the output-format spec and fix table could live in a reference file), it exceeds the under-50-line simple-skill exemption, and the referenced `docs/corpus-review.md` / `docs/corpus-authoring.md` are repo-relative paths not present in the skill bundle, so their content cannot be verified.

4 / 5

Total

19

/

20

Passed

Description

100%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 exemplary: concrete third-person capability statements, a named tool, and an explicit 'Use when' clause with verbatim natural trigger phrases. Both 'what' and 'when' are fully answered with minimal conflict risk.

DimensionReasoningScore

Specificity

Names multiple concrete actions with the exact tool: 'Review a spec in this repo against the SpecTrace corpus of org standards, decisions, and commitments', 'Runs `spectrace corpus review` and formats what it emits', and 'find unaddressed obligations or stale citations'. Coverage is comprehensive with no gaps that would pull it to the 4 anchor.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is concrete (run `spectrace corpus review` and format its output against the org corpus), and the 'when' is an explicit 'Use when' clause with concrete trigger phrases and verbatim example utterances, mirroring the 5-anchor example pattern. Voice is third person ('Review', 'Runs'), so no voice penalty applies.

5 / 5

Trigger Term Quality

Includes quoted natural phrases a user would actually say: "corpus review this", "which standards apply to this spec", "is this spec covered", plus task-language synonyms ('review a spec against the corpus', 'check which standards a spec touches'). This is comprehensive coverage, not the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Clear niche (spec review against a versioned corpus of org standards/decisions/commitments) with a distinct tool name and niche-specific trigger phrases, so overlap with other skills is minimal and it would not fire for the wrong skill.

5 / 5

Total

20

/

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

tslateman/spec-trace

Path

.claude/skills/spec-review/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.