CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-spec

Implement the result of /to-spec and /to-tickets in code.

Quality

76%

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 ./.agents/skills/implement-spec/SKILL.md

The canonical home for this skill is implement-spec in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplary lean orchestration skill: clearly sequenced steps, concrete subagent and worktree instructions, and explicit validation via a code-review pass. Its only weaknesses are a few unspecified mechanisms (branch creation, ticket-closure semantics) and no recovery guidance for failed subagents or merge conflicts.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout ("The tickets are not a list of steps. They are a **task graph**", "Communicate primarily through **context pointers**"), assuming Claude's competence with no padding or explanation of known concepts. Every token earns its place; only trivial repetition ("maximum concurrency" appears twice) keeps it from being pure, which does not reach the level of a measurable flaw.

5 / 5

Actionability

Guidance is mostly concrete and executable for an instruction-only skill: "calls the Skill tool with `tdd`", "each in its own worktree on its own branch", "merges the integration branch tip into its own branch before reporting done", "call the Skill tool with `code-review`". Minor gaps remain — no explicit command or method for creating the integration branch, and "resolve each ticket the way the issue tracker closes work" defers the concrete mechanism to unspecified context — so it falls short of fully copy-paste-ready.

4 / 5

Workflow Clarity

Nine clearly sequenced steps with an explicit validation checkpoint (step 7: code-review on the integration branch, then "Fix all issues raised") and an error-recovery checkpoint ("confirms its worktree is based on the integration branch before starting, and resets onto it if not"). The batch/merge workflow does include validation, so the cap does not apply, but there are no instructions for handling failed implementer subagents or merge conflicts, and no re-review loop after fixes — clear sequence with minor validation gaps rather than the fully closed-loop anchor.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and well organized into an intro plus a `## Steps` section with no external references — and no bundle files exist, so nothing is inlined that belongs elsewhere. Per the simple-skill guideline, this earns a 5 on well-organized sections alone.

5 / 5

Total

18

/

20

Passed

Description

53%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 concise and clearly states what the skill does, with distinctive references to its companion skills, but it is thin: one action, no 'when to use' guidance, and no trigger synonyms. It reads as a chain-link label rather than a self-contained trigger description.

Suggestions

Add an explicit trigger clause, e.g. "Use after running /to-spec and /to-tickets, when the user asks to implement the spec or work through the tickets."

List the concrete actions performed — e.g. "orchestrates implementer subagents across the ticket task graph, merges work to a single integration branch, and runs code review" — to improve specificity and keyword coverage.

Include natural trigger synonyms such as "build the tickets", "turn the spec into code", or "implement the tickets" so users' phrasings match without relying solely on the slash-command names.

DimensionReasoningScore

Specificity

The description names its concrete inputs ("the result of /to-spec and /to-tickets") and a single action ("Implement ... in code") — domain plus one action, matching the 1-2 concrete actions anchor. It omits the several concrete actions the skill actually performs (branch orchestration, subagent management, merging, code review), so it is not comprehensive enough for 4.

3 / 5

Completeness

The 'what' is clear ("Implement the result of /to-spec and /to-tickets in code") but there is no 'Use when...' clause; the 'when' is only weakly implied by naming the chained slash commands, capping completeness at 3 per the guideline. It is above anchor 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant keywords are present ("implement", "spec", "tickets", "code", "/to-spec", "/to-tickets") but there are no common variations or synonyms a user might naturally say (e.g. "build the tickets", "turn the spec into code"). This matches the "some relevant keywords but missing variations" anchor rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

Tying itself to specific companion skills ("/to-spec and /to-tickets") gives it a clear niche with mostly distinct triggers. Generic words like "Implement" and "in code" leave minor overlap risk with general implementation requests, keeping it below the minimal-conflict anchor 5.

4 / 5

Total

13

/

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

withcoral/coral

Path

.agents/skills/implement-spec/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.