CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

xp-mikado-method

Apply the Mikado Method for safe refactoring via a dependency graph of small steps. Use when the user asks for Mikado Method, safe refactoring, or dependency graph for a large change.

Quality

85%

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.

The body delivers a tight, actionable Mikado workflow with a clear sequence, explicit revert/test feedback loops, and a well-sectioned single-file structure that needs no external references. Only minor polish is available: trim the core-loop restatement and add a small example of graph notation.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's familiarity with XP concepts, with only minor trimmable redundancy — the "Core loop" restates the later five steps, and coaching questions like "Why does this change matter?" add little — placing it at anchor 4 rather than 5.

4 / 5

Actionability

Concrete directives throughout ("List each failure as a prerequisite", "implement → test → commit → integrate", "Always revert failed attempts") with only minor gaps such as no example graph notation or worked instance, which keeps it below anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The five-step sequence is clearly ordered and embeds an explicit error-recovery feedback loop (try → observe what breaks → revert → recurse) plus validation checkpoints (test before commit, revert on failure), matching anchor 5.

5 / 5

Progressive Disclosure

This is a ~50-line single-purpose skill with well-organized sections (Context, Task, Deliverables, Rules), no bundle files, and no content that belongs in a separate file — per the rubric's simple-skill guideline this earns a 5 with just well-organized sections.

5 / 5

Total

18

/

20

Passed

Description

78%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 well-formed description that follows the what/when pattern with a named, distinctive method and explicit trigger phrases. Its main gaps are moderate action specificity and a few missing natural synonyms (e.g., "large refactoring", "incremental changes").

Suggestions

Enumerate 2-3 concrete actions in the "what" clause, e.g., "define the goal, map prerequisites into a dependency graph, and commit leaf changes first" to raise specificity.

Add natural trigger variations such as "large refactoring", "break down a big change", or "incremental refactoring" to broaden keyword coverage.

Narrow the "safe refactoring" trigger (e.g., "safe, incremental refactoring of a large change") to reduce overlap with general refactoring skills.

DimensionReasoningScore

Specificity

Names the domain and mechanism ("safe refactoring via a dependency graph of small steps") but does not enumerate several concrete actions such as defining a goal, mapping prerequisites, or executing leaf changes first — matching anchor 3 rather than 4's "several specific actions".

3 / 5

Completeness

Explicitly answers both "what" ("Apply the Mikado Method for safe refactoring via a dependency graph of small steps") and "when" with concrete trigger phrases ("Use when the user asks for Mikado Method, safe refactoring, or dependency graph for a large change"), matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage ("Mikado Method", "safe refactoring", "dependency graph", "large change") that users would plausibly say, but common variations like "break down a large refactoring" or "incremental refactoring" are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The named method gives it a clear niche, but "safe refactoring" is broad enough to attract general refactoring requests that may not want the Mikado approach, so it is "mostly distinct; minor overlap risk" rather than minimal conflict.

4 / 5

Total

16

/

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

saski/arnesto

Path

.agents/skills/xp-mikado-method/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.