CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

craft

Implements a feature by executing a plan phase-by-phase — writes tests first, runs them red, then implements code to make them green, then validates nothing is broken. Use when you have a plan from /draft and are ready to implement, build, develop, create, or write code for a feature using TDD.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 well-structured orchestration skill with an exemplary workflow: explicit gates, remediation feedback loops, a hard escalation cap, and clean one-level-deep progressive disclosure into a real reference file. The main cost is redundancy — end-of-run verification and gate-failure handling are each stated multiple times — which inflates the token budget without adding guidance.

Suggestions

Merge 'Final Verification' and 'After Implementation' into one section — both instruct running the full test suite and verifying acceptance criteria.

Consolidate gate-failure handling into a single location (the loop's step f, 'Gate Failures', and Remediation step 5 currently repeat the same STOP/escalation rules three times).

Inline a one-line pointer to the agent prompt template in workflow-detail.md at the 'Dispatching Agents' step, so the orchestrator knows where the dispatch prompt comes from without scrolling.

DimensionReasoningScore

Conciseness

Mostly efficient orchestration prose, but genuine duplication: 'Final Verification' and 'After Implementation' both mandate running the full test suite and verifying acceptance criteria, and gate-failure handling is stated three times (loop step f, 'Gate Failures', and Remediation step 5). Not 4: the redundancy exceeds 'minor instances that could be trimmed'.

3 / 5

Actionability

Concrete tool calls (beads:ready, beads:show, beads:close, beads:create, beads:list), an explicit label taxonomy, title templates like 'P{N}: Remediate — {Phase Name} (attempt {M})', and a worked progress-report example. Not 5: the core loop is control-flow pseudocode and the agent prompt templates are deferred entirely to workflow-detail.md, leaving minor gaps at dispatch time.

4 / 5

Workflow Clarity

Clear sequence (identify epic → orchestration loop → report progress → final verification) with explicit validation gates (RED/GREEN), a remediation feedback loop capped at 2 attempts, STOP-and-escalate rules, and a 'What Not to Do' checklist. Matches the top anchor: explicit validation steps, error-recovery feedback loops, and a checklist for a complex process.

5 / 5

Progressive Disclosure

The body is a well-organized overview with the core loop inline, and details (agent prompt templates, dispatch procedures) are split into a single clearly-signaled reference (references/workflow-detail.md), verified to exist and only one level deep with no nested references. Not 4: the split and navigation are exactly appropriate for the content volume.

5 / 5

Total

17

/

20

Passed

Description

88%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 strong description: third-person, concrete, covers the complete TDD execution pipeline, and pairs it with an explicit 'Use when' trigger anchored on a /draft plan. Trigger synonyms are good though not exhaustive, and the generic implementation verbs carry slight conflict risk with general coding skills.

DimensionReasoningScore

Specificity

Multiple specific concrete actions cover the full pipeline ('writes tests first, runs them red, then implements code to make them green, then validates nothing is broken'), with the capability stated in third person. Not 4: there are no coverage gaps within its niche of plan-driven TDD implementation.

5 / 5

Completeness

Explicitly answers both what ('implements a feature by executing a plan phase-by-phase — writes tests first...') and when ('Use when you have a plan from /draft and are ready to implement...'). Not 4: both halves are concrete and fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good keyword coverage with synonym spread ('implement, build, develop, create, or write code for a feature using TDD') plus the '/draft' anchor. Not 5: common natural phrases like 'execute the plan', 'make the tests pass', or 'test-driven' are missing.

4 / 5

Distinctiveness Conflict Risk

The 'plan from /draft' dependency carves a clear niche, but the broad trigger verbs ('implement, build, develop, create, or write code') leave minor overlap risk with general coding skills. Not 5: those generic verbs could plausibly fire without a /draft plan present.

4 / 5

Total

18

/

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

ericjohnolson/tessl-test

Path

plugins/crafter/skills/craft/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.