nWave-ai/nWave / nWave/skills/nw-command-design-patterns-authoring
nw-command-design-patterns-authoring
VerifiedThe v2.8+ new-command installation contract - which three files to produce and their frontmatter when creating a brand-new command
New-Command Authoring & Installation Format (KNOWLEDGE)
Kind: KNOWLEDGE (reference). Composed by nw-command-design-patterns core. Fires when: a brand-NEW command is being created and the question is "which files do I produce, in what format, where" (the v2.8+ install contract). Distinct from classification (sizing an existing command) and reduction (trimming a bloated one). No forced sequence.
Command Installation Format (v2.8+)
Since v2.8.0, commands are installed as skills, not as separate command files. The installer reads from nWave/skills/nw-{command-name}/SKILL.md, NOT from nWave/tasks/nw/{command-name}.md. The legacy tasks/nw/*.md path is still supported but is NOT auto-installed.
When creating a new command, produce THREE files:
-
nWave/skills/nw-{name}/SKILL.md— the installable command skill. Frontmatter MUST include:--- name: nw-{name} description: "One-line description for slash command menu" user-invocable: true argument-hint: "[args] - Example: \"example usage\"" ---Body: the full command definition (same content as the declarative template).
-
nWave/tasks/nw/{name}.md— legacy task file (kept for backward compat + reference). Same content, simpler frontmatter (justdescription+argument-hint). -
nWave/skills/nw-{name}-methodology/SKILL.md(optional) — deep methodology knowledge for the agent. Frontmatter:--- name: nw-{name}-methodology description: "Methodology knowledge for {name}" user-invocable: false disable-model-invocation: true ---
The skill file (nWave/skills/nw-{name}/SKILL.md) is the PRIMARY deliverable. Without it, the command won't appear in the /nw- menu after installation. The task file is secondary.
Also update nWave/framework-catalog.yaml with the command entry under the appropriate wave section.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |