CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-loop-implementation-flow

Use this skill after execution approval for implementation work in an approved chat-only or task-file task. It governs implementation-time routing, canonical task updates, and the final review checkpoint.

Quality

79%

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/spec-loop-implementation-flow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 disciplined, well-structured router skill: tight rules, an explicit read-and-select sequence, and clean delegation to purpose-stated companion files. It is held back from excellent by small redundancies (duplicated description line and source-of-truth rule) and by the fact that its referenced guidance files are not present in the bundle, leaving the deferred mechanics unreachable.

Suggestions

Ship the referenced companion files (implementation-flow-guidance.md, chat-only-path-guidance.md, task-file-path-guidance.md) alongside SKILL.md, or inline a one-line definition of the `Implementation notes` check and the `review` state so the body is self-sufficient if they are absent.

Remove the verbatim repeat of the frontmatter description as the body's first line and merge the second "source of truth" restatement into the Core rules bullet, cutting ~10 lines with no loss of information.

DimensionReasoningScore

Conciseness

The body is lean (~65 lines), assumes Claude's competence, and pads nothing — but the opening line repeats the frontmatter description verbatim, "Keep...the approved active task as the source of truth" appears twice (Core rules and again after path selection), and the closing fallback partially restates the opening one. These are minor trims, matching anchor 4 rather than 5's "every token earns its place".

4 / 5

Actionability

Concrete, executable instructions for a router skill: exactly which files to read and in what order ("Read spec-loop-plan-task/SKILL.md and the files it requires"), an explicit two-way path choice, and concrete routing rules for out-of-scope work. Per the code-vs-instruction note, the absence of code is not penalized; the minor gap is that key mechanics (the "Implementation notes" check, the meaning of `review`) are named but defined only in referenced files, holding it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The sequence is coherent: precondition check with explicit fallback (no approved task → return to plan skill), ordered reading, explicit path selection, then the pre-completion "Implementation notes" check. Checkpoints are present but the gating check's content lives in a referenced file, and Core rules precede the Read/path-selection ordering a reader would follow — clear sequence with minor gaps, i.e. anchor 4, not 5's explicit in-body validation steps.

4 / 5

Progressive Disclosure

The structure is exactly what progressive disclosure wants: a lean SKILL.md that points to one-level-deep detail files, each reference clearly signaled with its stated purpose ("defines the route rules, when canonical task sections may change..." / "defines the active path mechanics..."). Scored against the actual bundle, however, none of the referenced files (implementation-flow-guidance.md, chat-only-path-guidance.md, task-file-path-guidance.md) exist in the skill directory, so navigation cannot be verified — good structure with a real gap, anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

76%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 precise, well-scoped router-style description that answers what and when explicitly and occupies a distinct niche. Its main weakness is trigger vocabulary dominated by internal workflow jargon, which limits natural-phrase matching for users who don't speak the spec-loop terminology.

Suggestions

Add one or two natural-language trigger synonyms alongside the state-based trigger, e.g. "Use after execution approval (when the user says 'go ahead' / 'implement it') for implementation work in an approved chat-only or task-file task."

Replace one abstract governance term (e.g. "canonical task updates") with a plainer equivalent ("keeps the approved task as the single source of truth") so users outside the spec-loop vocabulary can recognize the skill.

DimensionReasoningScore

Specificity

The description lists several specific governance areas — "implementation-time routing, canonical task updates, and the final review checkpoint" — rather than vague filler, though "governs" frames duties abstractly and it stops short of saying what routing or updates concretely involve. It fits anchor 4 (several specific actions, minor gaps) better than 3 (only 1-2 concrete actions) and falls short of 5's comprehensive action coverage.

4 / 5

Completeness

Both questions are explicitly answered: "when" via the concrete trigger "after execution approval for implementation work in an approved chat-only or task-file task", and "what" via the three named responsibilities. Anchor 4's weakness ("'when' could be more explicit or specific") does not apply here — the when-condition is maximally explicit — so it reaches anchor 5.

5 / 5

Trigger Term Quality

Relevant trigger phrases exist ("after execution approval", "implementation work", "review checkpoint") but the vocabulary is internal spec-loop jargon ("chat-only or task-file task", "canonical task updates") with no natural synonyms a user would say (e.g. "build it", "start coding", "go ahead"). This matches anchor 3 — some relevant keywords, missing common variations — rather than 4, since natural user phrasings are largely absent.

3 / 5

Distinctiveness Conflict Risk

The trigger carves a clear niche (post-approval implementation phase of a spec-loop), so it is unlikely to fire for unrelated skills. Minor overlap risk remains with sibling bundle skills (spec-loop-plan-task, spec-loop-clarify-task) whose state-based triggers could be confused at boundaries, matching anchor 4 rather than 5's "minimal conflict risk".

4 / 5

Total

16

/

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

relative_links

Relative link issues: 4 missing, 5 suspicious

Warning

Total

15

/

16

Passed

Repository

dpolivaev/spec-loop

Path

skills/spec-loop-implementation-flow/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.