Agent skill

Nw Review

by nWave-ai in nWave-ai/nWave

Dispatches an expert reviewer agent to critique workflow artifacts.

MITAuto-check passedTesting & QA

Install Nw Review

skills CLI
$ npx skills add nWave-ai/nWave --skill nw-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nWave-ai/nWave nw-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .claude/skills && cp -r skills-src/nWave/skills/nw-review .claude/skills/nw-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nw-review
GitHub stars
616
Token cost
~1.9k tokens
SKILL.md length
739 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Dispatches an expert reviewer agent to critique workflow artifacts.

  • Works in 5 steps: Parse parameters — Strip @ from agent… → Read rigor config — Read… → Validate inputs — Run all four… → …
  • Step needs quality review before proceeding
  • SKILL.md covers Overview, Review Philosophy: Radical…, Feedback Format: Conventional… and Approval Criteria, plus 10 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Nw Review is an agent skill from nWave-ai/nWave. Dispatches an expert reviewer agent to critique workflow artifacts. Use when a roadmap, implementation, or step needs quality review before proceeding.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. The repository describes itself as: AI agents that guide you from idea to working code, with you in control at every step. The licence is MIT.

When your agent uses it

  • Step needs quality review before proceeding

Example prompts

  • “Use the nw-review skill to dispatch an expert reviewer agent to critique workflow artifacts”
  • “/nw-review”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Parse parameters — Strip @ from agent name, resolve artifact path to absolute, extract optional step_id, dimensions, from/to range. Gate…
  2. Read rigor config — Read .nwave/des-config.json key rigor. If absent, use standard defaults. Gate: rigor profile loaded or defaults applied.
  3. Validate inputs — Run all four validation checks below. Gate: zero validation failures.
  4. Apply rigor overrides — Check review_enabled (skip if false), determine model from reviewer_model (default: haiku, skip if "skip"). Gate…
  5. Invoke reviewer — Call Task tool with subagent_type="{agent-name}-reviewer", resolved model, and prompt "Review {artifact-type}…

What it can do on your machine

Read from SKILL.md and the folder at commit da401a8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nw Review loads about 1.9k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 739 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nWave-ai/nWave at commit da401a8, republished under its MIT licence (© nWave-ai). 739 words, ~1,854 tokens.

Download SKILL.mdSave it as .claude/skills/nw-review/SKILL.md (or your agent's skills folder).
name
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:

LabelPurposeBlocking?
praise:Highlight something done well (genuine, not filler)No
issue (blocking):Must be resolved before proceedingYes
issue (blocking, security):Security vulnerability — maximum directnessYes
suggestion:Propose improvement with reasoningMark (blocking) or (non-blocking)
nitpick (non-blocking):Trivial, preference-basedNo
question (non-blocking):Seek clarification before assumingNo
thought (non-blocking):Idea sparked by the reviewNo

Findings MUST be priority-ordered: blocking issues first, then suggestions, then nitpicks/praise.

Approval Criteria

VerdictCriteria
APPROVEDNo blocking issues. Non-blocking feedback is advisory.
NEEDS_REVISIONBlocking issues exist. Author must address. Each blocking issue enumerated.
REJECTEDFundamental 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). -reviewer suffix 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: If false, skip the review entirely. Output: "Review skipped per rigor profile (review_enabled=false)."
  • reviewer_model: Pass as model parameter to Task tool. If "skip", skip the review. Overrides the default Haiku model.
  • double_review: If true and called from deliver Phase 4, the caller is responsible for invoking review twice.

Agent Derivation

User providesReviewer invoked
@nw-software-crafternw-software-crafter-reviewer
@nw-solution-architectnw-solution-architect-reviewer
@nw-platform-architectnw-platform-architect-reviewer

Default model: Haiku (overridden by rigor.reviewer_model when set).

Show full SKILL.md (352 more words)Show less

Agent Invocation

  1. Parse parameters — Strip @ from agent name, resolve artifact path to absolute, extract optional step_id, dimensions, from/to range. Gate: all parameters parsed.
  2. Read rigor config — Read .nwave/des-config.json key rigor. If absent, use standard defaults. Gate: rigor profile loaded or defaults applied.
  3. Validate inputs — Run all four validation checks below. Gate: zero validation failures.
  4. Apply rigor overrides — Check review_enabled (skip if false), determine model from reviewer_model (default: haiku, skip if "skip"). Gate: execution decision made.
  5. 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)

  1. Agent exists — Strip @, check agent name against agent registry. Gate: agent found or return "Unknown agent: {name}. Check available agents with /nw-agents."
  2. 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."
  3. Artifact file exists — Resolve to absolute path and confirm file exists. Gate: file found or return "Artifact not found: {path}."
  4. step_id present when required — Require step_id when artifact type is step or implementation. 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

© nWave-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in nWave/skills/nw-review of nWave-ai/nWave.

Open the folder on GitHubat commit da401a8

Compare with similar skills

Nw Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nw Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nw Review this skillnWave-ai/nWave616—~1.9kAutomated safety check: PassMIT
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k32 repos~2.1kAutomated safety check: PassApache-2.0
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    pietheinstrengholt/rssmonster

    Test-driven development. An agent skill from pietheinstrengholt/rssmonster.

    564 GitHub starsUsed in 30 repos~906 tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    381 GitHub starsUsed in 9 repos~2.9k tokens
    Testing & QAAuto-check passed

More from nWave-ai/nWave

All 14 skills in this repo
  • DELIVER wave orchestration workflow -- 9 phases from baseline to finalization.

    616 GitHub stars~974 tokensUpdated 25 days ago
    Auto-check passed
  • Nw Diagram

    nWave-ai/nWave

    Generates C4 architecture diagrams (context, container, component) in Mermaid or PlantUML.

    616 GitHub stars~640 tokensUpdated 25 days ago
    Auto-check passed
  • Nw Diverge

    nWave-ai/nWave

    Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence.

    616 GitHub stars~2.2k tokensUpdated 25 days ago
    Auto-check passed
  • Nw Document

    nWave-ai/nWave

    Creates evidence-based documentation following DIVIO/Diataxis principles.

    616 GitHub stars~1.4k tokensUpdated 25 days ago
    Auto-check passed
  • Nw Execute

    nWave-ai/nWave

    A skill your agent uses when a DELIVER roadmap already exists and you need to dispatch exactly one identified step through its TDD cycle.

    616 GitHub stars~3k tokensUpdated 25 days ago
    Auto-check passed
  • Nw Forge

    nWave-ai/nWave

    Creates new specialized agents using the 5-phase workflow (ANALYZE DESIGN CREATE VALIDATE REFINE).

    616 GitHub stars~626 tokensUpdated 25 days ago
    Auto-check passed

Categories

Questions about Nw Review

What does Nw Review do?

Dispatches an expert reviewer agent to critique workflow artifacts. Nw Review is an agent skill from nWave-ai/nWave. Dispatches an expert reviewer agent to critique workflow artifacts.

When should I use Nw Review?

Nw Review fits situations like: step needs quality review before proceeding.

How do I install Nw Review in Claude Code?

Run `npx skills add nWave-ai/nWave --skill nw-review -a claude-code`. Or copy the skill folder (nWave/skills/nw-review in nWave-ai/nWave) into .claude/skills/nw-review in your project. Claude Code loads it when a task matches its description.

How do I install Nw Review in Codex?

Run `npx skills add nWave-ai/nWave --skill nw-review -a codex`. Or copy the skill folder (nWave/skills/nw-review in nWave-ai/nWave) into .agents/skills/nw-review in your project. Codex loads it when a task matches its description.

Can I use Nw Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nWave-ai/nWave --skill nw-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nw-review, .gemini/skills/nw-review, .github/skills/nw-review and .opencode/skills/nw-review in your project.

What does Nw Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Nw Review is instructions for the agent only.

Does Nw Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nw Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nw Review use?

Nw Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nw Review use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nw Review?

Skills that share tags, products or a category with Nw Review: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (pietheinstrengholt/rssmonster, 564 stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nw Review?

nWave-ai (a GitHub organization) maintains it in nWave-ai/nWave, which has 616 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 16, 2026.

Source: nWave-ai/nWave on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.