@postwave/claude-code-plugin

Postwave for Claude Code, in one install.

A single npm package that drops a curated set of Postwave skills, an MCP server hookup, and a CLAUDE.md snippet into any Claude Code project. After installation, your agent knows how to draft emails in your voice, diagnose deliverability, run migrations, and more — without any manual plumbing.

MIT licensed. Layer 2 of the Postwave open-core architecture (see LICENSE-BOUNDARY.md in the monorepo).

Install

In any project that uses Claude Code:

npx @postwave/claude-code-plugin
# alias: npx postwave-cc-install

The installer is interactive. It will:

1. Detect that you're inside a project (looks for package.json or .git in any parent directory).
2. Ask whether to install skills at project scope (.claude/skills/) or personal scope (~/.claude/skills/).
3. Copy the seven Postwave skills into the chosen location with the postwave- prefix.
4. Offer to print the claude mcp add postwave … command so the agent can call the Postwave MCP server.
5. Offer to append the Postwave conventions snippet to your CLAUDE.md (or create one if you don't have it yet).
6. Print next steps: get an API key, run postwave login, try the first skill.

What gets created

your-project/
├── .claude/
│   └── skills/
│       ├── postwave-email/SKILL.md
│       ├── postwave-diagnose/SKILL.md
│       ├── postwave-migrate/SKILL.md
│       ├── postwave-preview/SKILL.md
│       ├── postwave-sequence/SKILL.md
│       ├── postwave-deliverability-audit/SKILL.md
│       └── postwave-voice-tune/SKILL.md
└── CLAUDE.md  (optionally appended)

If you chose personal scope, the skills land in ~/.claude/skills/ instead and are available across every project.

Skills

| Skill | What it does | | --- | --- | | postwave-email | Draft an email body in your voice using the email primitives. | | postwave-diagnose | Run the AI diagnostician on a campaign and present ranked fixes. | | postwave-migrate | Walk an end-to-end migration from another platform. | | postwave-preview | Compile and preview an email JSX file in the local browser. | | postwave-sequence | Generate a multi-email sequence in your voice from a template. | | postwave-deliverability-audit | Top-to-bottom SPF / DKIM / DMARC / BIMI / reputation audit. | | postwave-voice-tune | Add a new source to your voice profile and rebuild it. |

Each skill has disable-model-invocation: false (the default), meaning Claude can invoke it automatically when your prompt matches its description. You can always invoke one explicitly with /postwave-<name>.

Opt-in

Nothing in this package runs unless you explicitly invoke it. The installer never executes the MCP add command for you — it prints the command so you can review and run it yourself. Skills are just markdown; they only act when Claude Code reads them.

Uninstall

npx postwave-cc-install --uninstall

This removes any directory under .claude/skills/ (or ~/.claude/skills/) whose name starts with postwave-. The installer also prints a one-line command you can run to strip the Postwave block from your CLAUDE.md.

License

MIT. See LICENSE.

Links

• GitHub: https://github.com/postwave/claude-code-plugin
• Postwave: https://postwave.dev
• Claude Code docs: https://code.claude.com/docs