@dotworld/shadow-canary-skill
v0.7.2
Published
Claude Code skill for operating the shadow-canary deployment pattern
Readme
@dotworld/shadow-canary-skill
Claude Code skill for operating the shadow-canary deployment pattern on Next.js + Vercel projects.
Installation
npx @dotworld/shadow-canary-skill installOr with force-reinstall:
npx @dotworld/shadow-canary-skill install --forceThis copies the skill into ~/.claude/skills/shadow-canary/. Claude Code auto-discovers it and makes the slash commands available in any project session.
Slash commands
| Command | Description |
|---|---|
| /shadow-canary:install | Install shadow-canary on the current project |
| /shadow-canary:status | Show canary state, traffic split, and recent deploys |
| /shadow-canary:pause | Pause the canary ramp (cron skips bumps) |
| /shadow-canary:resume | Resume the canary ramp |
| /shadow-canary:promote | Jump to 100% immediately (confirmation required) |
| /shadow-canary:cancel | Revert to previous deploy at 0% (confirmation required) |
| /shadow-canary:rollback [sha] | Promote an older production deploy |
| /shadow-canary:deploy <shadow\|prod> [flags] | Trigger shadow or prod deploy via git |
| /shadow-canary:doctor | Verify installation and configuration |
Prerequisites
- Claude Code installed (
npm i -g @anthropic-ai/claude-code) - A project with shadow-canary installed (run
/shadow-canary:installto set up) .shadow-canary.jsonat the project root (created by the install command)ADMIN_USER,ADMIN_PASSin.env.localor environment
Deploy flags
/shadow-canary:deploy prod # normal canary ramp
/shadow-canary:deploy prod --skip-canary # jump to 100% on deploy
/shadow-canary:deploy prod --keep-canary # fix-in-place, no ramp restart
/shadow-canary:deploy shadow # update shadow (1% mirror)