CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-spec

在代码中实现 /to-spec 和 /to-tickets 的产出。

Quality

76%

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/engineering/implement-spec/SKILL.md
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 a lean, imperative 9-step orchestration workflow with explicit checkpoints (worktree-base verification, integration-tip merges, frontier updates after each merge, a mandatory code-review pass) and zero padding or known-concept explanation. Minor unspecified failure paths — merge conflicts and what the merger does when a ticket fails — keep actionability and workflow clarity at 4 rather than 5.

DimensionReasoningScore

Conciseness

The body is ~35 lines of pure imperative instruction with no padding and no explanation of concepts Claude already knows (worktrees, task graphs, PRs are used, not taught). Lines like '与 subagents 的通信应当简洁。主要通过 context pointers 通信…不要重复 pointers 已经提供的信息' are operational rules, not filler — every token earns its place.

5 / 5

Actionability

Guidance is concrete and executable: exact Skill invocations ('调用 Skill 工具并指定 tdd', 'code-review'), explicit preconditions ('开始前确认其 worktree 基于 integration branch,若不是则 reset 到它上面', '在报告完成前,把 integration branch 的 tip 合并进自己的 branch'), and conditional PR rules in step 3. Minor gaps keep it from a 5: merge-conflict handling, what the merger subagent does on failure, and the exact location for research notes (step 2's 'repo 外…的目录') are unspecified. It is well above the pseudocode-level anchor of 3.

4 / 5

Workflow Clarity

Nine explicitly numbered steps form a coherent sequence with real checkpoints: implementers verify/reset their worktree base and merge the integration tip before reporting done, the frontier is re-evaluated after every merge to launch more subagents, and a mandatory code-review pass with fixes runs before the PR is marked ready. Validation is present, so the batch-operation cap at 3 does not apply. Not a 5 because error-recovery loops for likely failures (merge conflicts, failing or blocked tickets, missing issue tracker mid-run) are not addressed.

4 / 5

Progressive Disclosure

This is a single-file skill under 50 lines with no bundle files at all (references/, scripts/, and assets/ directories do not exist), organized into a short intro plus a numbered 步骤 section. Per the rubric's simple-skill exception, well-organized sections with no need for external references score 5.

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 terse and carves out a distinct niche — implementing the artifacts produced by /to-spec and /to-tickets — but it states only a single action and completely omits when-to-use guidance, leaving completeness and trigger-term quality at mid-scale. A user who does not already know the sibling slash commands would have little basis for reaching this skill.

Suggestions

Add a 'Use when...' clause (e.g., “Use when you have a spec from /to-spec and tickets from /to-tickets and need to implement them in the codebase”) so the 'when' is explicitly answered and completeness can exceed 3.

Include natural trigger terms users would actually say — spec, tickets, implementation, integration branch, parallel subagents — alongside the slash-command names to broaden trigger-term coverage.

Briefly enumerate the concrete actions (resolve tickets per the issue tracker, orchestrate implementer/merger subagents on separate worktrees, open a draft PR) so specificity goes beyond the single 'implement' action.

DimensionReasoningScore

Specificity

「在代码中实现 /to-spec 和 /to-tickets 的产出」names the domain (the artifacts of /to-spec and /to-tickets) and exactly one concrete action — implementing them in code — matching the '1-2 concrete actions, not comprehensive' anchor. It is not a 2 because the slash-command references make the action specific rather than generic, and not a 4 because branching, subagent orchestration, and ticket-resolution mechanics are entirely unmentioned.

3 / 5

Completeness

The 'what' is stated clearly (implement the outputs of /to-spec and /to-tickets in code), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 4 because the 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

The only keywords are the slash-command names '/to-spec' and '/to-tickets' plus '实现' (implement). These are relevant to users of this skill family, but natural phrases and common variations a user would actually say (spec, tickets, implementation, integration branch, parallel subagents) are missing — the 'some relevant keywords but missing common variations or synonyms' anchor.

3 / 5

Distinctiveness Conflict Risk

Being tied to the specific /to-spec and /to-tickets pipeline gives it a clear niche that is distinguishable from generic coding skills — mostly distinct with only minor overlap risk against sibling implementation/setup skills. It is not a 5 because the anchor's clear trigger phrases ('Use when...') are absent, leaving slight ambiguity against adjacent skills in the same family.

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

vinvcn/mattpocock-skills-zh-CN

Path

skills/engineering/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.