CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-implementation

AI DevKit · Implementation phase guidance for executing feature plans and checking implementation against design. Use when the user wants to implement planned tasks, update implementation docs, verify code matches design, or run dev-lifecycle phases 5 and 7.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tightly written, instruction-only lifecycle skill: an efficient directive body with concrete commands, explicit validation checkpoints, and well-structured sections appropriate for a sub-50-line skill with no bundle files. The only gap is a couple of underspecified artifacts like the markdown tracking snippet format.

Suggestions

Show a one-line example or field list for the 'markdown tracking snippet' in step 11 so the output format is unambiguous without relying on the parent dev-lifecycle skill's conventions.

Briefly specify what a 'phase, progress, next-step, blocker, and evidence' event looks like (or point to where the format is defined) so the tracing step is executable even if the parent context is unavailable.

DimensionReasoningScore

Conciseness

The 49-line body is dense, directive, and free of padding — it never explains concepts Claude already knows (no 'what TDD is', no library tutorials) and each numbered step states a rule or command. It matches the anchor-5 'lean and efficient; every token earns its place' profile; anchor 4 would require noticeable over-explanation that is absent here.

5 / 5

Actionability

Concrete, executable guidance dominates: copy-paste commands ('npx ai-devkit@latest lint --feature <name>'), config resolution ('.ai-devkit.json' 'paths.docs', falling back to 'docs/ai'), explicit task statuses, and per-task doc update contents. It misses anchor 5 because a few items remain underspecified — e.g., step 11 says 'Generate a markdown tracking snippet after each status change' without showing the snippet's shape, and the phase-tracing event format is left entirely to the parent dev-lifecycle skill.

4 / 5

Workflow Clarity

Both phase sections have clearly sequenced numbered steps with explicit validation checkpoints: lint before work, TDD's failing-test-first loop, the 'verify' skill before completion claims, per-task doc lockstep updates, 'After each section, ask if new tasks were discovered', and error-recovery routing ('If major deviations exist, return to dev-design if design is wrong or Execute Plan if implementation is wrong'). This matches the anchor-5 pattern of clear sequence, explicit validation, and feedback loops.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for external references, and its sections (Phase Contract, Execute Plan, Check Implementation) are well-organized. Per the rubric's simple-skill guideline, well-organized sections alone merit 5; the cross-references it does make (tdd, verify, dev-planning, dev-testing, dev-review) are one level deep and clearly signaled.

5 / 5

Total

19

/

20

Passed

Description

83%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 well-constructed description that clearly states what the skill does and when to use it, with concrete action verbs and an explicit trigger clause. Its only weaknesses are a slightly narrow action list and a few missing natural synonyms in the trigger terms.

Suggestions

Add a natural synonym trigger or two (e.g., 'execute the plan' or 'implementation review') to broaden the 'Use when' phrasing beyond the system-specific phase vocabulary.

Consider naming one more concrete capability in the what-clause (e.g., producing the per-task markdown tracking snippets) so the action coverage feels comprehensive rather than phase-minimal.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'executing feature plans', 'checking implementation against design', 'update implementation docs', and 'run dev-lifecycle phases 5 and 7' — rather than vague capability claims. It falls short of anchor 5 because coverage is narrowly scoped to the two lifecycle phases, while it exceeds anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ('Implementation phase guidance for executing feature plans and checking implementation against design') and a concrete 'when' with four explicit trigger phrases in the 'Use when...' clause. This matches the anchor-5 example structure of a clear capability statement followed by concrete 'Use when' triggers.

5 / 5

Trigger Term Quality

The 'Use when' clause provides good natural trigger phrases — 'implement planned tasks', 'update implementation docs', 'verify code matches design', 'run dev-lifecycle phases 5 and 7' — that users of this toolkit would plausibly say. It misses anchor 5 because common synonyms like 'execute the plan', 'code the tasks', or 'implementation review' are absent, and the phase-number jargon is system-specific.

4 / 5

Distinctiveness Conflict Risk

The 'AI DevKit' brand prefix and phase-specific triggers ('dev-lifecycle phases 5 and 7', 'checking implementation against design') give it a clear niche within its skill family with minimal conflict risk. It is not anchor 5 because 'implement planned tasks' and 'verify code matches design' could mildly overlap with sibling skills like dev-planning or a general code-review skill.

4 / 5

Total

17

/

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

codeaholicguy/ai-devkit

Path

skills/dev-implementation/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.