Spec Workflow
hashgraph-online/awesome-codex-plugins
This skill should be used when the user asks to "create a spec", "write requirements", "design a feature", "plan implementation", "use EARS notation", "create user stories", "break down tasks"…
Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence.
$ npx skills add nWave-ai/nWave --skill nw-diverge -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install nWave-ai/nWave nw-diverge --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .claude/skills && cp -r skills-src/nWave/skills/nw-diverge .claude/skills/nw-diverge && rm -rf skills-srcUse ~/.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/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .claude/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-divergeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add nWave-ai/nWave --skill nw-diverge -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install nWave-ai/nWave nw-diverge --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .agents/skills && cp -r skills-src/nWave/skills/nw-diverge .agents/skills/nw-diverge && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .agents/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add nWave-ai/nWave --skill nw-diverge -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install nWave-ai/nWave nw-diverge --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/nWave/skills/nw-diverge .cursor/skills/nw-diverge && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .cursor/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/nWave-ai/nWave.git --path nWave/skills/nw-diverge--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add nWave-ai/nWave --skill nw-diverge -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install nWave-ai/nWave nw-diverge --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/nWave/skills/nw-diverge .gemini/skills/nw-diverge && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .gemini/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install nWave-ai/nWave nw-divergeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add nWave-ai/nWave --skill nw-diverge -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .github/skills && cp -r skills-src/nWave/skills/nw-diverge .github/skills/nw-diverge && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .github/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add nWave-ai/nWave --skill nw-diverge -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install nWave-ai/nWave nw-diverge --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/nWave-ai/nWave.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/nWave/skills/nw-diverge .opencode/skills/nw-diverge && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "nw-diverge" agent skill from https://github.com/nWave-ai/nWave/tree/main/nWave/skills/nw-diverge into .opencode/skills/nw-diverge/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nw-diverge", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
nw-divergeGenerates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence.
Nw Diverge is an agent skill from nWave-ai/nWave. Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence. Use when the team has a validated problem but hasn't chosen a solution approach.
Its SKILL.md is about 2.2k 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 Agent Workflows, covering Brainstorming and User stories. 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.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit da401a8. It shows what the files ask for, not the result of running them.
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.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Nw Diverge loads about 2.2k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 829 words of instructions outside code blocks.
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.
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.
The full file from nWave-ai/nWave at commit da401a8, republished under its MIT licence (© nWave-ai). 829 words, ~2,172 tokens.
.claude/skills/nw-diverge/SKILL.md (or your agent's skills folder).Wave: DIVERGE (between DISCOVER and DISCUSS, optional) | Agent: Flux (nw-diverger) | Command: /nw-diverge
Execute DIVERGE wave through Flux's 4-phase workflow: JTBD analysis|competitive research|structured brainstorming|taste-filtered evaluation. Transforms a validated problem into 3-5 concrete, taste-scored design directions so DISCUSS can converge on one with confidence.
DIVERGE is optional. Brownfield features with a clear direction may skip it (see skip checklist in design spec). New products and pivot decisions benefit most from structured divergence.
Question: What type of work is this? Options:
Question: How deep should competitive research go? Options:
Before beginning DIVERGE work, read SSOT and prior wave artifacts:
docs/product/ exists):docs/product/jobs.yaml -- validated jobs and opportunity scoresdocs/product/vision.md -- product vision and strategic contextdocs/project-brief.md | docs/stakeholders.yaml (if available)docs/feature/{feature-id}/discover/ (if present)wave-decisions.md -- validated assumptions and key decisionsproblem-validation.md -- customer evidence grounding the problemMigration gate: If docs/product/ does not exist but docs/feature/ has existing features, STOP. Guide the user to docs/guides/migrating-to-ssot-model/README.md and complete the migration first. If greenfield, DIVERGE will bootstrap docs/product/jobs.yaml with the validated job.
READING ENFORCEMENT: You MUST read every file listed in Prior Wave Consultation above using the Read tool before proceeding. After reading, output a confirmation checklist. Do NOT skip files that exist -- skipping causes options disconnected from evidence.
@nw-diverger
Execute *diverge for {feature-id}.
Context Files: see Prior Wave Consultation above + project context files.
Configuration:
SKILL_LOADING: Before starting work, load your skill files using the Read tool from ~/.claude/skills/nw-{skill-name}/SKILL.md. Skills encode your methodology -- without them you operate with generic knowledge only.
At the start of execution, create these tasks using TaskCreate and follow them in order:
jtbd-analysis skill. Extract and elevate the job from the raw request or DISCOVER evidence. Produce job statements (functional + emotional + social) and ODI outcome statements. Gate: job at strategic or physical level (not tactical), minimum 3 ODI outcome statements produced.nw-researcher sub-agent for evidence-grounded competitive research. Map how existing products serve the validated job. Identify non-obvious alternatives. Gate: 3+ real competitors named, at least one non-obvious alternative, evidence quality confirmed.brainstorming skill. Frame HMW question, apply SCAMPER lenses, generate structurally diverse options. Gate: 6 options generated with diversity confirmed (mechanism, assumption, and cost structure differ across options).taste-evaluation skill. Apply DVF filter, score surviving options on 4 taste criteria with locked weights, produce weighted ranking and recommendation with dissenting case. Gate: all surviving options scored on all 4 criteria, recommendation traceable to scoring matrix, dissenting case documented.nw-diverger-reviewer (Prism) to validate all 5 dimensions. Revise if needed (max 2 iterations). Gate: reviewer approval confirmed, handoff accepted by nw-product-owner.Handoff To: nw-product-owner (DISCUSS wave)
Deliverables: recommendation.md with explicit decision statement + supporting DIVERGE artifacts
Before completing DIVERGE, produce (or append to) docs/feature/{feature-id}/wave-decisions.md:
# DIVERGE Decisions -- {feature-id}
## Key Decisions
- [D1] {decision}: {rationale} (see: {source-file})
## Job Summary
- Validated job: {job statement at strategic/physical level}
- ODI outcomes: {count} outcome statements
## Options Evaluated
- {count} options generated, {count} survived DVF filter
- Recommended: {option name} -- {one-line rationale}
- Dissent: {second-place option} -- {why it might be better under different assumptions}
## SSOT Updates
- jobs.yaml: {created|updated} with job JOB-{NNN}After producing feature-level artifacts, update the product-level SSOT:
docs/product/jobs.yaml with the validated job from Phase 1. Add changelog entry referencing this feature-id.docs/product/ does not exist, create the directory. This is the SSOT bootstrap.SSOT files use schema_version and changelog fields. See canonical schema in the design spec.
docs/feature/{feature-id}/) recommendation.md (top 3 options, dissenting case, decision for DISCUSS)
wave-decisions.md (DIVERGE section appended)docs/feature/{feature-id}/diverge/) job-analysis.md (validated job + ODI outcome statements)
competitive-research.md (prior art, competitor analysis, non-obvious alternatives)
options-raw.md (all generated options, unfiltered, no evaluation)
taste-evaluation.md (DVF filter, locked weights, scoring matrix)
review.yaml (peer review result from nw-diverger-reviewer)docs/product/) jobs.yaml (created or updated with validated job + changelog entry)/nw-diverge notification-systemDISCOVER artifacts present with validated problem. Flux reads problem-validation.md, extracts job ("minimize likelihood of developers missing critical failure signals"), researches 5 notification tools including non-obvious alternatives (ambient light signals, IDE annotations), generates 6 structurally diverse options, scores with taste evaluation, recommends proactive push with Slack integration. Updates jobs.yaml with validated job.
/nw-diverge rate-limitingNo DISCOVER artifacts. Flux works from project-brief.md and direct conversation. Extracts job via 5 Whys from "we need rate limiting" to strategic level. Creates docs/product/jobs.yaml (SSOT bootstrap). Proceeds through all 4 phases.
/nw-diverge --skip auth-bugfixSkip checklist evaluated: clear direction exists (bugfix), no competing approaches, self-evident path. DIVERGE skipped. User directed to /nw-discuss or /nw-distill depending on work type.
© 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
Just SKILL.md in nWave/skills/nw-diverge of nWave-ai/nWave.
Open the folder on GitHubat commit da401a8
Nw Diverge 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Nw Diverge this skillnWave-ai/nWave | 616 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Spec Workflowhashgraph-online/awesome-codex-plugins | 1.3k | — | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Specifygenkovich/sdd | 171 | — | ~3.6k | Automated safety check: Pass | MIT | |
| Synthesis Buildacogood/diffmode_free | 163 | — | ~5.3k | Automated safety check: Pass | Apache-2.0 | |
| Idea Refinementaddyosmani/agent-skills | 105k | 6 repos | ~2k | Automated safety check: Pass | MIT | |
| CE BrainstormEveryInc/compound-engineering-plugin | 25k | — | ~1.9k | Automated safety check: Pass | MIT |
hashgraph-online/awesome-codex-plugins
This skill should be used when the user asks to "create a spec", "write requirements", "design a feature", "plan implementation", "use EARS notation", "create user stories", "break down tasks"…
genkovich/sdd
A skill your agent uses to turn a raw feature idea into a reviewed spec.md — a lightweight Socratic interview front (capture the idea, deep-dive the problem) merged with a full product spec…
acogood/diffmode_free
Synthesis BUILD stage — the FINAL stage of the Diffmode growth-tactics pipeline (fuses white-space ideation + founder-fit adaptation & merge — formerly two separate synthesis passes — into ONE…
addyosmani/agent-skills
Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.
EveryInc/compound-engineering-plugin
Turns a vague or ambitious feature idea into a requirements-only plan through dialogue with you, sized to the work, before any code is written.
prime-radiant-inc/iterative-development
Reads human-written spec documents and produces per-epic requirement files with proof obligations plus behavior scenarios with stable IDs, using parallel chunked extraction.
nWave-ai/nWave
DELIVER wave orchestration workflow -- 9 phases from baseline to finalization.
nWave-ai/nWave
Generates C4 architecture diagrams (context, container, component) in Mermaid or PlantUML.
nWave-ai/nWave
Creates evidence-based documentation following DIVIO/Diataxis principles.
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.
nWave-ai/nWave
Creates new specialized agents using the 5-phase workflow (ANALYZE DESIGN CREATE VALIDATE REFINE).
nWave-ai/nWave
Applies the Refactoring Priority Premise (RPP) levels L1-L6 for systematic code refactoring.
Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence. Nw Diverge is an agent skill from nWave-ai/nWave. Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence.
Nw Diverge fits situations like: the team has a validated problem but hasnt chosen a solution approach; tasks that involve Brainstorming; tasks that involve User stories.
Run `npx skills add nWave-ai/nWave --skill nw-diverge -a claude-code`. Or copy the skill folder (nWave/skills/nw-diverge in nWave-ai/nWave) into .claude/skills/nw-diverge in your project. Claude Code loads it when a task matches its description.
Run `npx skills add nWave-ai/nWave --skill nw-diverge -a codex`. Or copy the skill folder (nWave/skills/nw-diverge in nWave-ai/nWave) into .agents/skills/nw-diverge in your project. Codex loads it when a task matches its description.
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-diverge -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-diverge, .gemini/skills/nw-diverge, .github/skills/nw-diverge and .opencode/skills/nw-diverge in your project.
SKILL.md names no scripts, command-line tools or credentials: Nw Diverge is instructions for the agent only.
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.
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.
Nw Diverge is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Nw Diverge: Spec Workflow (hashgraph-online/awesome-codex-plugins, 1.3k stars), Specify (genkovich/sdd, 171 stars), Synthesis Build (acogood/diffmode_free, 163 stars) and Idea Refinement (addyosmani/agent-skills, 105k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
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.