How do I install the Nw Mikado skill?

Run npx skillmds@latest add nwave-ai/nw-mikado-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Nw Mikado skill do?

[EXPERIMENTAL] Complex refactoring roadmaps with visual tracking It is listed under Coding & Dev Tools on SkillMD.

Is Nw Mikado safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nw Mikado?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nw Mikado free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nw Mikado?

nWave-ai (@nwave-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nw Mikado by nwave-ai — Agent Skill

Name: Nw Mikado
Author: nWave-ai

File contents

Code facts — resolve structural facts about code through des code-fact CLI (vendor-neutral, bundled adapters: AST then TextSearch). Degrade LOUD. Never ad-hoc grep. Example: des code-fact query.callers-of SYMBOL --root ROOT.

NW-MIKADO: Complex Refactoring with Mikado Method

EXPERIMENTAL: Under active development. Behavior and output format may change between versions.

Wave: CROSS_WAVE Agent: Crafty (nw-software-crafter) Command: *mikado

Overview

Plan and execute complex refactoring using the Mikado Method. Builds dependency {visualization} through iterative exploration|tracks discoveries via commits|executes leaf-to-goal bottom-up. For architectural changes spanning multiple classes where simple refactoring is insufficient.

Context Files Required

src/* - Codebase to refactor
docs/product/architecture/brief.md - Target architecture (if available)

Agent Invocation

@nw-software-crafter

Execute *mikado for {refactoring-goal}.

Context Files:

src/*
docs/product/architecture/brief.md

Configuration:

refactoring_goal: "{goal description with business value}"
complexity: complex # simple/moderate/complex
visualization: {tree|graph} # tree = indented markdown checklist, graph = Mermaid dependency diagram

Success Criteria

Mikado {visualization} persisted at docs/mikado/{goal-name}.mikado.md
Discovery commits capture each exploration attempt
All leaf nodes implemented bottom-up
Goal node achieved with all tests passing
{visualization_label} stable (no new dependencies emerging)

Visualization labels: tree → "Tree", graph → "Graph". Use the selected visualization type in all output messages (e.g., "Wrote the Mikado tree" or "Wrote the Mikado graph").

Next Wave

Handoff To: {invoking-agent-returns-to-workflow} Deliverables: Refactored codebase + Mikado {visualization} documentation

Examples

Example 1: Extract shared domain model

/nw-mikado "Extract shared domain model from monolithic service layer"

Crafty builds Mikado dependency {visualization} through iterative exploration, discovers 12 leaf nodes across 4 modules, executes bottom-up from leaves to goal with discovery commits at each step.

Expected Outputs

docs/mikado/{goal-name}.mikado.md
src/*                                (refactored implementation)
Discovery-tracking commits in git log

---name: nw-mikado-2description: "[EXPERIMENTAL] Complex refactoring roadmaps with visual tracking"---> **Code facts** — resolve structural facts about code through `des code-fact` CLI (vendor-neutral, bundled adapters: AST then TextSearch). Degrade LOUD. Never ad-hoc grep. Example: `des code-fact query.callers-of SYMBOL --root ROOT`.# NW-MIKADO: Complex Refactoring with Mikado Method> **EXPERIMENTAL**: Under active development. Behavior and output format may change between versions.**Wave**: CROSS_WAVE**Agent**: Crafty (nw-software-crafter)**Command**: `*mikado`## OverviewPlan and execute complex refactoring using the Mikado Method. Builds dependency {visualization} through iterative exploration|tracks discoveries via commits|executes leaf-to-goal bottom-up. For architectural changes spanning multiple classes where simple refactoring is insufficient.## Context Files Required- src/\* - Codebase to refactor- docs/product/architecture/brief.md - Target architecture (if available)## Agent Invocation@nw-software-crafterExecute \*mikado for {refactoring-goal}.**Context Files:**- src/\*- docs/product/architecture/brief.md**Configuration:**- refactoring_goal: "{goal description with business value}"- complexity: complex # simple/moderate/complex- visualization: {tree|graph} # tree = indented markdown checklist, graph = Mermaid dependency diagram## Success Criteria- [ ] Mikado {visualization} persisted at docs/mikado/{goal-name}.mikado.md- [ ] Discovery commits capture each exploration attempt- [ ] All leaf nodes implemented bottom-up- [ ] Goal node achieved with all tests passing- [ ] {visualization_label} stable (no new dependencies emerging)**Visualization labels**: tree → "Tree", graph → "Graph". Use the selected visualization type in all output messages (e.g., "Wrote the Mikado tree" or "Wrote the Mikado graph").## Next Wave**Handoff To**: {invoking-agent-returns-to-workflow}**Deliverables**: Refactored codebase + Mikado {visualization} documentation## Examples### Example 1: Extract shared domain model```/nw-mikado "Extract shared domain model from monolithic service layer"```Crafty builds Mikado dependency {visualization} through iterative exploration, discovers 12 leaf nodes across 4 modules, executes bottom-up from leaves to goal with discovery commits at each step.## Expected Outputs```docs/mikado/{goal-name}.mikado.mdsrc/* (refactored implementation)Discovery-tracking commits in git log```

Frequently asked questions

Nw Mikado