How do I install the Matilha Review skill?

Run npx skillmds@latest add danilods/matilha-review 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.

Is Matilha Review safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Matilha Review?

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 Matilha Review free to use?

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

Who published Matilha Review?

danilods (@danilods) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Matilha Review by danilods — Agent Skill

Name: Matilha Review
Author: danilods

File contents

When this fires

After /matilha-gather completes a wave, user says "review this wave" or "is this good quality". Wave 3c ship will automate the 6-agent review; until then this skill runs a simplified sequential review.

Preconditions

docs/matilha/waves/wave-NN-status.md shows status: completed.
review_report: null (or user wants a re-review).

Execution Workflow

Read wave-status via Read tool.
Confirm all SPs merged and regression passed.
If superpowers:dispatching-parallel-agents available, invoke via Skill tool with 6 review roles (code-quality, UX, security, architecture, performance, docs). Otherwise, run each review role sequentially via Task tool.
Synthesize outputs into docs/matilha/reviews/<date>-wave-NN-review.md.
Update wave-status: review_report: <path>.

Rules: Do

Preserve reviewer independence (don't synthesize until all reviews return).
Cite specific commits + files in findings.
Surface blockers distinctly from nice-to-haves.

Rules: Don't

Fix issues yourself (reviewer surfaces, humans fix).
Synthesize before all reviews complete.
Mark wave as reviewed without the review_report link.

Expected Behavior

User gets a structured markdown with one section per reviewer + a synthesis. Wave 3c will automate; until then this skill is the manual fallback.

Quality Gates

review_report exists.
wave-NN-status.md:review_report updated.

Companion Integration

If superpowers:dispatching-parallel-agents is available: dispatch 6 review agents in parallel via Skill tool.
Otherwise: run each review role sequentially (slower; same output quality).

Output Artifacts

docs/matilha/reviews/<date>-wave-NN-review.md.
Updated wave-NN-status.md.

Example Constraint Language

Use "must" for: all 6 review roles produce output.
Use "should" for: dispatch parallel via superpowers when available.
Use "may" for: skip review for trivial waves (user decision).

Troubleshooting

"wave not completed": Finish /matilha-gather first.
"review_report already exists": Inspect existing; don't overwrite.

CLI shortcut (optional)

Wave 3c will ship matilha review <slug>. Until then, no CLI equivalent exists.

---name: matilha-reviewdescription: Use when user wants a quality review of a completed wave — will dispatch 6 parallel review agents (code-quality, UX, security, architecture, performance, docs) once Wave 3c ships.---## When this firesAfter `/matilha-gather` completes a wave, user says "review this wave" or "is this good quality". Wave 3c ship will automate the 6-agent review; until then this skill runs a simplified sequential review.## Preconditions- `docs/matilha/waves/wave-NN-status.md` shows `status: completed`.- `review_report: null` (or user wants a re-review).## Execution Workflow1. Read wave-status via Read tool.2. Confirm all SPs merged and regression passed.3. If `superpowers:dispatching-parallel-agents` available, invoke via Skill tool with 6 review roles (code-quality, UX, security, architecture, performance, docs). Otherwise, run each review role sequentially via Task tool.4. Synthesize outputs into `docs/matilha/reviews/<date>-wave-NN-review.md`.5. Update wave-status: `review_report: <path>`.## Rules: Do- Preserve reviewer independence (don't synthesize until all reviews return).- Cite specific commits + files in findings.- Surface blockers distinctly from nice-to-haves.## Rules: Don't- Fix issues yourself (reviewer surfaces, humans fix).- Synthesize before all reviews complete.- Mark wave as reviewed without the review_report link.## Expected BehaviorUser gets a structured markdown with one section per reviewer + a synthesis. Wave 3c will automate; until then this skill is the manual fallback.## Quality Gates- `review_report` exists.- `wave-NN-status.md:review_report` updated.## Companion Integration- If **superpowers:dispatching-parallel-agents** is available: dispatch 6 review agents in parallel via Skill tool.- Otherwise: run each review role sequentially (slower; same output quality).## Output Artifacts- `docs/matilha/reviews/<date>-wave-NN-review.md`.- Updated `wave-NN-status.md`.## Example Constraint Language- Use "must" for: all 6 review roles produce output.- Use "should" for: dispatch parallel via superpowers when available.- Use "may" for: skip review for trivial waves (user decision).## Troubleshooting- **"wave not completed"**: Finish `/matilha-gather` first.- **"review_report already exists"**: Inspect existing; don't overwrite.## CLI shortcut (optional)> Wave 3c will ship `matilha review <slug>`. Until then, no CLI equivalent exists.

Frequently asked questions

Matilha Review