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

78%

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 ./tiles/crafter/skills/craft/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 exemplary procedural skill: a fully specified orchestration loop with gates, remediation, and escalation, backed by a clearly signaled one-level-deep reference containing copy-paste agent prompt templates. The one real weakness is redundancy — the agent-isolation rules and per-agent context breakdowns are repeated across sections and could be consolidated without losing anything.

Suggestions

Consolidate the three restatements of the agent pattern: state the Write Test / Implement / Validate roles once (Purpose), and reduce the Agent Isolation Discipline and Context Compaction sections to the few rules they add.

Trim "When to Use" to the bullets that add information beyond the frontmatter description (e.g. drop the resuming/don't-use overlap already implied elsewhere), saving lines for no loss.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and stays on procedural facts, but the three-agent pattern (Write Test / Implement / Validate) is restated three times — in Purpose, Agent Isolation Discipline, and Context Compaction — and "When to Use" re-treads the description. This is "mostly efficient but could be tightened" (anchor 3) rather than the minor-trim profile of anchor 4.

3 / 5

Actionability

Guidance is fully executable: exact execution-log line formats, a completely specified orchestration loop with concrete beads:* commands, precise remediation issue titles ("P{N}: Remediate — {Phase Name} (attempt {M})"), an explicit parallel-dispatch instruction (single message, multiple Task calls), and copy-paste agent prompt templates in the referenced file. This matches anchor 5; anchor 4 would imply gaps in the common cases, and none are apparent.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (Identify Epic → Orchestration Loop → Report Progress → Final Verification) with explicit RED/GREEN/VALIDATE gates and a validate → remediate → re-validate feedback loop capped at 2 attempts with escalation to the user. This matches anchor 5's requirement of explicit validation steps plus error-recovery feedback loops.

5 / 5

Progressive Disclosure

The body serves as the overview and correctly splits the bulk detail (agent prompt templates, dispatch details, remediation templates) into references/workflow-detail.md, which exists, is clearly signaled at the point of need ("See [workflow-detail.md](references/workflow-detail.md) for agent prompt templates and dispatch details"), and is one level deep with no further nested references. This matches anchor 5.

5 / 5

Total

18

/

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 correctly pairs a what with an explicit "Use when" clause and is anchored to a specific methodology, avoiding generic fluff. Its main weakness is jargon-heavy phrasing (RPI, beads-driven) and thin natural trigger-term coverage, which limit how well a user's everyday phrasing would surface this skill.

Suggestions

Rewrite the capability statement in plain terms alongside the jargon, e.g. "Runs an implementation plan issue-by-issue, dispatching isolated agents that write tests first, then code, then validation — closing each task only when its tests pass."

Broaden the trigger phrase with natural synonyms: "Use when implementing, executing, or working through a plan produced by /draft, or when resuming an in-progress implementation."

Add one or two concrete capability details that users would recognize (e.g. parallel task execution, automatic remediation of failing tests) to lift specificity.

DimensionReasoningScore

Specificity

"Executes beads-driven task graph using isolated agents for test-first discipline" names the domain with 2 concrete actions, but coverage is not comprehensive (gates, remediation, and progress reporting are unmentioned) and the actions lean on project-internal jargon. This matches anchor 3 rather than 4, which requires several listed specific actions with only minor gaps.

3 / 5

Completeness

Both parts are present: the what ("Executes beads-driven task graph using isolated agents for test-first discipline") and an explicit when ("Use when executing an implementation plan from the draft skill"). Not a 5 because the what is expressed through jargon ("beads-driven task graph") that a cold reader cannot resolve, leaving it less than fully explicit and concrete.

4 / 5

Trigger Term Quality

"Use when executing an implementation plan" is a natural trigger phrase, but terms like "RPI methodology", "beads-driven", and "test-first discipline" are internal jargon and common user variations (e.g. "build the feature", "work through the plan") are absent. Some relevant keywords exist but synonyms are missing, matching anchor 3 rather than 4's fuller keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The anchoring to the RPI pipeline and the upstream draft skill ("from the draft skill") gives it a clear niche with distinct triggers, matching anchor 4. Not 5 because "implement" / "executing an implementation plan" are generic enough to overlap with ordinary implementation requests, so minor conflict risk remains.

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

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