CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

051-design-two-steps-methods

Use when a complex or risky code change should be split into Kent Beck's two-step method by first making the change easy through behavior-preserving preparatory refactoring, then making the intended behavior change once the design supports it. This should trigger for requests such as Apply two-step change; Make this risky change safer; Refactor before changing behavior; Separate preparation from behavior change. Part of Plinth Toolkit

69

Quality

87%

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

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.

A well-structured, efficient skill body: clear constraints, a numbered workflow with validation checkpoints and an explicit error-recovery loop, and proper use of a single one-level-deep reference file. The only real gap is minor redundancy between the coverage list and the workflow, and actionability that stays at the technique-name level rather than executable specifics.

DimensionReasoningScore

Conciseness

The body is efficient, assumes Claude's competence, and never explains concepts Claude already knows (no primer on refactoring or Kent Beck). Minor redundancy: the 'What is covered in this Skill?' list partially restates the Workflow, and 'When to use this skill' repeats the description triggers verbatim, so it is not fully lean like anchor 5.

4 / 5

Actionability

For an instruction-only skill, the guidance is mostly actionable: step 2 names concrete techniques ('extract method or class, clarify names, isolate dependencies, add seams for testing, add characterization tests') and step 4 names concrete validation options (existing tests, build checks, characterization tests, manual verification). Not a 5 because no commands or worked examples are given and some steps remain direction-level ('inspect the relevant code and tests').

4 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with explicit validation checkpoints after each phase (step 4 'Validate preserved behavior', step 6 'Verify and report the outcome') and an explicit error-recovery loop ('If behavior changes unexpectedly, fix or revert the preparation before proceeding'), matching anchor 5 exactly.

5 / 5

Progressive Disclosure

The body is a well-organized overview that delegates detail to a single real one-level-deep reference (references/051-design-two-steps-methods.md, verified to exist), referenced both in the workflow and in a dedicated Reference section. Structure is clean and easy to navigate, matching anchor 5.

5 / 5

Total

18

/

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 strong description that explicitly covers both what the skill does and when to trigger it, with natural trigger phrases. Its weaknesses are mild: the action list is limited to the method's two steps rather than a broader set of concrete capabilities, and a few natural synonyms appear only in the body.

Suggestions

Trim the method explanation ('by first making the change easy through behavior-preserving preparatory refactoring, then making the intended behavior change once the design supports it') to reduce padding while keeping the two concrete actions.

Add the natural synonym trigger 'Make the change easy, then make the easy change' to the trigger list so it matches the body's 'When to use' section.

Consider adding a keyword like 'Kent Beck two-step' or 'refactoring first' to the trigger list to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('complex or risky code change') and concrete actions ('behavior-preserving preparatory refactoring', 'making the intended behavior change once the design supports it'), but covers only the two-step method's actions rather than several specific operations, sitting between anchors 3 and 4. It is not a 5 because it does not enumerate multiple distinct concrete actions with comprehensive coverage.

4 / 5

Completeness

It explicitly answers both 'what' (split a change into behavior-preserving preparation followed by the intended behavior change) and 'when' ('Use when a complex or risky code change should be split...' plus 'This should trigger for requests such as...') with concrete trigger phrases. It clearly matches the anchor 5 example structure and is not merely adequate like anchor 4.

5 / 5

Trigger Term Quality

It lists natural user phrases ('Apply two-step change; Make this risky change safer; Refactor before changing behavior; Separate preparation from behavior change') that users would plausibly say. Not a 5 because common synonyms such as 'make the change easy, then make the easy change' (present only in the body) are missing from the description.

4 / 5

Distinctiveness Conflict Risk

The two-step change method is a distinct niche with specific triggers unlikely to fire for unrelated skills, though it could minorly overlap with a general refactoring skill. It is mostly distinct with minor overlap risk, matching anchor 4 rather than the minimal-conflict clarity of anchor 5.

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

jabrena/plinth

Path

skills/051-design-two-steps-methods/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.