nw-review
Dispatches an independent reviewer for a durable authority, immutable oracle, candidate diff, charter set, or operational artifact.
Install / Use
npx skills add nWave-ai/nWave --skill nw-reviewInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of nw-review
nw-review scores 90/100 on our quality scale, 1440th of 4,702 Development & Engineering skills we index (top 31%).
Its SKILL.md is 7.2 KB long, well organised into 19 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
It has 617 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so nw-review is actively maintained.
- Our last check on 2026-10-11 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-09. Automated pattern scan on 2026-10-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
nw-review compared with similar skills
All 4 of these similar skills score higher than nw-review; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nw-review (this skill)by nWave-ai | 90 | 617 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.6k | 9d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.3k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.4k | 3d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.7k | today | MCP Server |
Frequently asked questions
- How do I install nw-review?
- Run
npx skills add nWave-ai/nWave --skill nw-review. The install tabs above show the steps for each supported agent. - Which AI agents does nw-review work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is nw-review safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is nw-review still maintained?
- The repository was last updated about 2 months ago, so nw-review is actively maintained.
Skill content
View source on GitHubname: nw-review description: "Dispatches an expert reviewer agent to critique workflow artifacts. Use when a roadmap, implementation, or step needs quality review before proceeding." user-invocable: true argument-hint: '[agent] [artifact-type] [artifact-path] - Example: @software-crafter task "roadmap.json"'
NW-REVIEW: Expert Critique and Quality Assurance
Wave: CROSS_WAVE Agent: Dynamic (nw-*-reviewer)
Overview
Dispatches expert reviewer agent to critique workflow artifacts. Takes base agent name, appends -reviewer, invokes with artifact. Reviewer agent owns all review methodology|criteria|output format.
Review Philosophy: Radical Candor
Every review MUST embody Radical Candor — kind AND clear, specific AND sincere:
- Care personally: Acknowledge what works. Understand author's intent before critiquing. Include at least one genuine
praise:per review. - Challenge directly: Be specific about what is wrong and WHY. Ground feedback in evidence|consequences, not preference. Never soften security/data-loss issues.
- Avoid ruinous empathy: Never "LGTM" when real issues exist. Hedging ("maybe consider possibly...") on blocking concerns is a review failure.
- Avoid obnoxious aggression: Never "this is terrible" without constructive alternative. Focus on work, not author. Explain "why" behind every critique.
Feedback Format: Conventional Comments
All findings MUST use Conventional Comments labels:
| Label | Purpose | Blocking? |
|---|---|---|
| praise: | Highlight something done well (genuine, not filler) | No |
| issue (blocking): | Must be resolved before proceeding | Yes |
| issue (blocking, security): | Security vulnerability — maximum directness | Yes |
| suggestion: | Propose improvement with reasoning | Mark (blocking) or (non-blocking) |
| nitpick (non-blocking): | Trivial, preference-based | No |
| question (non-blocking): | Seek clarification before assuming | No |
| thought (non-blocking): | Idea sparked by the review | No |
Findings MUST be priority-ordered: blocking issues first, then suggestions, then nitpicks/praise.
Approval Criteria
| Verdict | Criteria | |---|---| | APPROVED | No blocking issues. Non-blocking feedback is advisory. | | NEEDS_REVISION | Blocking issues exist. Author must address. Each blocking issue enumerated. | | REJECTED | Fundamental design problems requiring significant rework. Rare — explain thoroughly, offer alternatives. |
Syntax
/nw-review @{agent-name} {artifact-type} "{artifact-path}" [step_id={id}] [--dimensions=rpp] [--from=1] [--to=3]
Parameters:
@{agent-name}- Base agent (e.g.,@nw-software-crafter).-reviewersuffix appended automatically.{artifact-type}- One of:baseline,roadmap,step,task,implementation{artifact-path}- Path to artifact file (resolved to absolute)step_id={id}- Required for step and implementation reviews--dimensions=rpp- Triggers RPP code smell scan alongside standard review (Dimension 4)--from=N/--to=N- RPP level range (default: 1-6). Requires--dimensions=rpp
Rigor Profile Integration
Before dispatching the reviewer agent, read rigor config from .nwave/des-config.json (key: rigor). If absent, use standard defaults.
review_enabled: Iffalse, skip the review entirely. Output: "Review skipped per rigor profile (review_enabled=false)."reviewer_model: Pass asmodelparameter to Task tool. If"skip", skip the review. Overrides the default Haiku model.double_review: Iftrueand called from deliver Phase 4, the caller is responsible for invoking review twice.
Agent Derivation
| User provides | Reviewer invoked |
|---|---|
| @nw-software-crafter | nw-software-crafter-reviewer |
| @nw-solution-architect | nw-solution-architect-reviewer |
| @nw-platform-architect | nw-platform-architect-reviewer |
Default model: Haiku (overridden by rigor.reviewer_model when set).
Agent Invocation
- Parse parameters — Strip
@from agent name, resolve artifact path to absolute, extract optional step_id, dimensions, from/to range. Gate: all parameters parsed. - Read rigor config — Read
.nwave/des-config.jsonkeyrigor. If absent, use standard defaults. Gate: rigor profile loaded or defaults applied. - Validate inputs — Run all four validation checks below. Gate: zero validation failures.
- Apply rigor overrides — Check
review_enabled(skip if false), determine model fromreviewer_model(default: haiku, skip if "skip"). Gate: execution decision made. - Invoke reviewer — Call Task tool with
subagent_type="{agent-name}-reviewer", resolved model, and prompt"Review {artifact-type}: {absolute-artifact-path} [step_id={id}]". Reviewer handles reading artifact, applying domain expertise, generating structured critique, updating original artifact with review metadata. Gate: Task tool invoked.
Validation (before invoking)
- Agent exists — Strip
@, check agent name against agent registry. Gate: agent found or return "Unknown agent: {name}. Check available agents with /nw-agents." - Artifact type valid — Confirm type is one of: baseline, roadmap, step, task, implementation. Gate: type valid or return "Invalid artifact type: {type}. Use: baseline, roadmap, step, task, implementation."
- Artifact file exists — Resolve to absolute path and confirm file exists. Gate: file found or return "Artifact not found: {path}."
- step_id present when required — Require step_id when artifact type is
steporimplementation. Gate: step_id provided or return "step_id required for {type} reviews."
Success Criteria
- [ ] Reviewer agent invoked (not self-performed)
- [ ] Original artifact file updated with review metadata
- [ ] Review includes severity levels and approval status (APPROVED, NEEDS_REVISION, REJECTED)
Examples
Example 1: Step review
/nw-review @nw-software-crafter step "docs/feature/auth-upgrade/execution-log.json" step_id=02-01
Invokes nw-software-crafter-reviewer with step review of execution log, step 02-01.
Example 2: Roadmap review
/nw-review @nw-solution-architect roadmap "docs/feature/auth-upgrade/roadmap.json"
Invokes nw-solution-architect-reviewer with roadmap review.
Example 3: Implementation review
/nw-review @nw-platform-architect implementation "docs/feature/auth-upgrade/execution-log.json" step_id=01-01
Invokes nw-platform-architect-reviewer with implementation review of step 01-01.
Example 4: RPP code quality review
/nw-review @nw-software-crafter implementation "src/des/" --dimensions=rpp --from=1 --to=3
Invokes nw-software-crafter-reviewer with implementation review + RPP L1-L3 code smell detection using cascade rule.
Error Messages
- Invalid agent: "Unknown agent: {name}. Check available agents with /nw-agents."
- Invalid type: "Invalid artifact type: {type}. Use: baseline, roadmap, step, task, implementation."
- Missing file: "Artifact not found: {path}."
- Missing step_id: "step_id required for {type} reviews."
Next Wave
Handoff To: Depends on review outcome (rework or proceed) Deliverables: Updated artifact file with embedded review metadata
Expected Outputs
Updated artifact file (roadmap.json, execution-log.json, etc.) with reviews section
Related Skills
taste-skill
117.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.3kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.4kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.7k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
