CtrlK
BlogDocsLog inGet started
Tessl Logo

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

80

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The SKILL.md body is a tight, well-organized overview of the two-step change method with a clear sequenced workflow, explicit validation feedback loops, and an appropriately split one-level reference. It assumes Claude's competence and stays actionable.

DimensionReasoningScore

Conciseness

The body is lean — a focused 'What is covered' list, terse MUST constraints, and a numbered workflow — with no padding explaining concepts Claude already knows; every section earns its place.

3 / 3

Actionability

It gives a concrete menu of refactorings ('extract method or class, clarify names, isolate dependencies, add seams for testing...') and specific verification means; as an instruction skill the absence of executable code is not penalized and the guidance is concrete, not abstract.

3 / 3

Workflow Clarity

The six-step workflow has explicit validation checkpoints (Step 4 'Validate preserved behavior', Step 6 'Verify and report') and a feedback loop ('If behavior changes unexpectedly, fix or revert the preparation before proceeding').

3 / 3

Progressive Disclosure

The body is an overview pointing to a single one-level-deep reference (references/051-design-two-steps-methods.md, which exists and contains no nested references), clearly signaled via a dedicated Reference section and an inline workflow pointer.

3 / 3

Total

12

/

12

Passed

Description

100%

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, well-structured description that clearly states what the skill does and when to invoke it using natural trigger language. It is concrete and distinct, with no voice or over-claim issues.

DimensionReasoningScore

Specificity

The description names concrete, distinct actions — 'behavior-preserving preparatory refactoring' followed by 'the intended behavior change' — rather than vague language, matching the multiple-specific-actions anchor.

3 / 3

Completeness

It explicitly answers both what (split a risky change into preparation then behavior change) and when, via both a 'Use when...' clause and a 'This should trigger for requests such as...' list.

3 / 3

Trigger Term Quality

Trigger phrases like 'Apply two-step change', 'Make this risky change safer', 'Refactor before changing behavior', and 'Separate preparation from behavior change' are natural requests a user would actually say, with good variation coverage.

3 / 3

Distinctiveness Conflict Risk

The Kent Beck two-step framing and specific triggers carve a clear niche unlikely to fire for unrelated skills, despite one somewhat broad phrase ('Make this risky change safer').

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.