CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

craft

Implement phase of RPI methodology. Executes beads-driven task graph using isolated agents for test-first discipline. Use when executing an implementation plan from the draft skill.

Quality

73%

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 ./.tessl/tiles/lightfactory/crafter/skills/craft/SKILL.md

The canonical home for this skill is craft in ericjohnolson/tessl-test

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 strong, execution-ready orchestration skill: the workflow loop, gates, remediation loop, and recovery story are explicit and concrete, with prompt templates correctly pushed to a well-signaled reference file. The main improvement opportunity is conciseness — gate-failure handling, agent roles, and progress-report examples are duplicated between the body, the workflow loop, and the reference.

Suggestions

Remove the duplicate "If RED Gate Fails" / "If GREEN Gate Fails" sections under Agent Isolation Discipline — the orchestration loop (step 2f) and the reference's Error Handling already cover them; keep one authoritative location.

Collapse the three explanations of the agent roles (Purpose, Agent Isolation Discipline, Context Compaction) into one, and replace the beads:list progress-report example in the body with a pointer to the reference.

State explicitly how remediation attempt counts are tracked (e.g., parsed from remediation issue titles) so the 2-attempt STOP rule is unambiguous.

DimensionReasoningScore

Conciseness

The body is mostly efficient but has real redundancy: RED/GREEN gate-failure handling appears both in the orchestration loop (step 2f) and again in full under "Agent Isolation Discipline"; the three-agent roles are explained three times (Purpose, Agent Isolation Discipline, Context Compaction); and the progress-report example appears in both the body and the reference. This matches anchor 3 — could be tightened — rather than 4's minor trimmable instances.

3 / 5

Actionability

The guidance is highly executable: exact loop pseudocode, exact execution-log line formats, concrete beads:ready/show/close/create commands, specific remediation issue titles/labels/dependency wiring, and copy-paste agent prompt templates in references/workflow-detail.md (a verified real file). It sits just below anchor 5 because a few operational details — how remediation attempt counts are tracked, what command constitutes each gate check — are left implicit or deferred to issue descriptions.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced with explicit validation checkpoints (RED/GREEN/VALIDATE gates), feedback loops for error recovery (remediation → re-validation with a 2-attempt cap), escalation paths to the user, session recovery, and quality checklists in the reference. This matches anchor 5 exactly.

5 / 5

Progressive Disclosure

The body is an overview with a single, clearly signaled, one-level-deep reference ([workflow-detail.md](references/workflow-detail.md)) that exists in the bundle. It falls short of anchor 5 because content is not perfectly split: the remediation procedure and the progress-report example are fully spelled out in both the body and the reference, a minor organization gap matching anchor 4.

4 / 5

Total

16

/

20

Passed

Description

62%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 answers both what and when explicitly and sits clearly within a distinct multi-phase methodology niche. Its main weaknesses are jargon-heavy capability language ("beads-driven task graph", "RPI methodology") and thin trigger-term coverage — a single when-clause with no synonyms or variations.

Suggestions

Rewrite capability phrases in user-recognizable terms, e.g. "Executes an implementation plan issue-by-issue: dispatches isolated agents to write tests first, then implement, then validate" instead of "beads-driven task graph" jargon.

Broaden the when-clause with natural variations users would say, e.g. "Use when executing, building from, or resuming an implementation plan created by /draft".

Include concrete trigger keywords such as "implementation plan", "TDD", "test-first", or "run the plan" so the description surfaces on natural phrasings.

DimensionReasoningScore

Specificity

"Executes beads-driven task graph using isolated agents for test-first discipline" names the domain and a couple of actions, but "beads-driven task graph" and "RPI methodology" are internal jargon rather than concrete user-recognizable capabilities. It lists only 1-2 concrete actions, matching anchor 3 rather than 4's several specific actions.

3 / 5

Completeness

Both what ("Executes beads-driven task graph using isolated agents for test-first discipline") and when ("Use when executing an implementation plan from the draft skill") are explicitly present. It falls short of anchor 5 because the when clause covers a single scenario with no additional concrete trigger phrases (e.g., resuming an interrupted session).

4 / 5

Trigger Term Quality

"Use when executing an implementation plan" is a natural phrase a user would say, but common variations and synonyms ("implement the plan", "build from the plan", "resume implementation") are absent from the description. This fits anchor 3 — some relevant keywords but missing common variations — rather than 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Implement phase of RPI methodology... executing an implementation plan from the draft skill" carves a clear niche within the Research→Plan→Implement pipeline, keeping conflict risk low. However the generic word "Implement" leaves minor overlap risk with general coding/build skills, matching anchor 4 rather than 5's minimal conflict risk.

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

ericjohnolson/tessl-test

Path

.tessl/tiles/lightfactory/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.