CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

draft

Plan phase of RPI methodology. Consumes research artifact or topic and produces compact implementation plan with test specs and Agent Context blocks. Use after research or to start planning a non-trivial feature.

Quality

82%

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

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.

The body delivers an exceptionally clear, well-validated workflow with concrete commands, a fallback mode, and an excellent worked example. Its weaknesses are repetition (the audit-trail/beads distinction and Agent Context requirements are each stated multiple times) and template detail inlined in SKILL.md that already lives in references/template.md.

Suggestions

State the audit-trail-vs-execution-source-of-truth distinction once (e.g., in Step 3's note) and remove the restatements in Step 3b, Step 4/5 output text, 'After Planning', and 'Context Compaction' — the body could drop ~40 lines.

Merge the 'Agent Context Blocks' section into Step 3's required-sections list (or delegate entirely to references/template.md, which already documents the fields) instead of specifying the required fields twice.

Replace the inlined required-sections and phase-ordering lists with a pointer to references/template.md, keeping SKILL.md focused on the procedure.

DimensionReasoningScore

Conciseness

The body is mostly efficient but repeats itself noticeably: the audit-trail-vs-execution-source-of-truth distinction is restated at least four times (Step 3 note, Step 3b intro, Step 4/5 output text, After Planning), Agent Context requirements appear in both Step 3 and a dedicated section, and phase ordering is given twice. This fits the 3 anchor (some unnecessary explanation, could be tightened) rather than 4's 'minor instances' since the repetition is systematic; not 2 because there is no padding of concepts Claude already knows.

3 / 5

Actionability

Highly concrete guidance: exact output paths (docs/plans/YYYY-MM-DD-{topic}-plan.md), command vocabulary (beads:epic, beads:dep, beads:label), a worked 6-phase decomposition, good/bad test-spec examples, and verbatim user-facing messages. Fits the 4 anchor (mostly executable, minor gaps) rather than 5 because the actual beads:* invocation syntax is never shown and several code blocks are placeholders.

4 / 5

Workflow Clarity

Five clearly sequenced steps with explicit checkpoints: a beads availability check with a documented inline fallback mode, RED/GREEN gates in Agent Context blocks, verification and approval checklists, and feedback loops ("If changes needed... I'll update both the plan and beads issues"). This matches the 5 anchor; no validation gaps were found.

5 / 5

Progressive Disclosure

A single one-level-deep reference (references/template.md, verified to exist) is well-signaled four times with clear purpose statements, and sections are clearly headed. Fits the 4 anchor rather than 5 because the body inlines template-like detail (required sections list, phase ordering, Agent Context fields) that duplicates what template.md already provides.

4 / 5

Total

16

/

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.

The description is strong: it clearly states both what the skill produces and when to use it, with concrete trigger conditions and distinctive methodology-specific terms. The main gaps are jargon reliance ("RPI methodology" unexplained) and a few missing natural synonyms.

DimensionReasoningScore

Specificity

"Consumes research artifact or topic and produces compact implementation plan with test specs and Agent Context blocks" lists several concrete actions in a named domain. It matches the 4 anchor (several specific actions, minor gaps) rather than 5 because "Plan phase of RPI methodology" leans on methodology jargon and coverage of what the skill does is slightly incomplete.

4 / 5

Completeness

Explicitly answers both: what ("produces compact implementation plan with test specs and Agent Context blocks") and when ("Use after research or to start planning a non-trivial feature"). The explicit 'Use after...' clause with concrete trigger conditions matches the 5 anchor, not 4 where the 'when' is only adequate.

5 / 5

Trigger Term Quality

Natural terms users would say are present: "implementation plan", "planning", "research", "non-trivial feature". Good keyword coverage but a few natural synonyms (e.g., "roadmap", "spec", "design doc") are missing, matching the 4 anchor rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

"Plan phase of RPI methodology" and "Agent Context blocks" carve a clear niche with distinctive vocabulary. Minor overlap risk remains with generic planning/roadmapping skills because "plan" is a common word, fitting the 4 anchor rather than 5.

4 / 5

Total

17

/

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