CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-spec

Implement a specification in code.

Quality

69%

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
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 efficient, well-sequenced orchestration workflow that correctly assumes Claude's competence and includes a frontier feedback loop and a code-review validation gate. Its main weakness is actionability: several steps (draft PR creation, the merge procedure, context-pointer format) are named but not executable without details the skill leaves to guesswork.

Suggestions

Add concrete commands or syntax for the executable steps — e.g. how to mark the PR as closing the spec issue ("Closes #<spec-issue>" in the PR description) and the worktree/branch commands implementers should use.

Specify the merger subagent's procedure: how to merge an implementer's branch into the PR branch, and what to do on merge conflicts (re-run the implementer, resolve manually, or rebase).

Add a per-ticket verification checkpoint (e.g., "before merging, confirm the ticket's changes build and tests pass") so validation is not deferred entirely to the final /code-review step.

DimensionReasoningScore

Conciseness

The ~35-line body is lean with no padding and no explanations of concepts Claude already knows — statements like "The tickets are not a list of steps. They are a **task graph**" convey skill-specific protocol, and every instruction earns its place. The only near-redundancy is the twice-repeated "maximum concurrency" rationale, which is too minor to drop it to 4.

5 / 5

Actionability

The steps name specific mechanisms ("Each implementer subagent should work in its own worktree, on its own branch", "marked as 'closing' the spec issue", "run /code-review on the PR branch") but miss key execution details: no commands or syntax for creating the draft PR/closing issues, no merge procedure or conflict-handling guidance for the merger subagent, and no format for the "context pointers" communication. This matches "Some concrete guidance but incomplete... missing key details" rather than 4's "minor gaps".

3 / 5

Workflow Clarity

The 9-step sequence is clearly ordered and includes an explicit feedback loop ("If this changes the **frontier**... kick off more **implementer subagents**") and a validation checkpoint ("run /code-review... Fix all issues raised"), matching "Clear sequence with most checkpoints present; minor validation gaps". Not a 5 because there is no per-merge verification (e.g., tests passing) before merging each implementer's work into the PR branch; not a 3 because two explicit checkpoints and a feedback loop are present.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no bundle files (no references/, scripts/, or assets/ exist), and needs none — all content fits in the single body with well-organized intro and ## Steps sections. Per the rubric's scoring note for simple/short skills, this earns a 5.

5 / 5

Total

17

/

20

Passed

Description

45%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 grammatically clean and in third person, but it is a single generic sentence: one vague action, no capability list, and no "Use when..." trigger guidance. Given the skill also sets disable-model-invocation, this may be intentional (user-invoked only), but judged as written it fails most rubric anchors for a strong description.

Suggestions

Expand the description with the skill's concrete capabilities, e.g. "Implements a full specification on a single branch by parallelizing its tickets as a task graph across implementer subagents, merging each into one PR via merger subagents, then validating with /code-review."

Add natural trigger phrasing such as "Use when the user provides a spec, specification, or ticket list and asks for a PR implementing the entire thing" (unless disable-model-invocation makes triggers moot, in which case at least document the scope).

Include common synonyms users would actually say — "spec", "tickets", "task graph", "parallel implementation" — to improve keyword coverage and distinctiveness.

DimensionReasoningScore

Specificity

"Implement a specification in code" names the domain (specifications) but provides only a single generic verb with no concrete actions, matching "Names the domain but actions are minimal or generic" (cf. "Processes PDF files"). It is not a 1 because it does name a real domain and action, and not a 3 because it lists no concrete, enumerated capabilities.

2 / 5

Completeness

The "what" is clear ("Implement a specification in code") but there is no "Use when..." clause or equivalent trigger guidance, capping completeness at 3 per the judging guidelines. It is not a 4 because the "when" is entirely absent rather than weakly present.

3 / 5

Trigger Term Quality

"specification", "implement", and "code" are natural terms a user would say, but the description misses common variations like "spec", "tickets", or "spec-driven development", matching "Some relevant keywords but missing common variations or synonyms". Not a 2 since the keywords are domain-specific rather than generic; not a 4 since there is no synonym or shorthand coverage at all.

3 / 5

Distinctiveness Conflict Risk

The phrase "Implement a specification in code" carves out a somewhat specific niche (spec implementation) but "implement...in code" broadly overlaps general coding-implementation skills, matching "Somewhat specific but could still overlap with similar skills". Not a 4 because the description alone gives no distinguishing trigger that separates it from ordinary implementation requests.

3 / 5

Total

11

/

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

tonykay/transcriber

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.