Refactor skill distribution; remove bumpy ai command

Move the canonical add-change agent skill to the repo root (skills/) as a
single source of truth, synced into the package on build/prepack (gitignored
copy) so it ships version-pinned in the npm tarball and via the Claude Code
plugin. Mirrors dmno-dev/varlock#808.

Remove the bumpy ai command: its file-copying targets (opencode/cursor/codex)
forked the skill into tool-specific dirs that drifted from canonical and were
silently broken in the published package, while the claude target just wrapped
claude plugin install. Skill is now installed via the plugin or referenced
directly from node_modules.

Author: theoephraim

.bumpy/skill-distribution.md

@@ -0,0 +1,9 @@
+---
+'@varlock/bumpy': patch
+---
+
+Streamline agent skill distribution and remove the `bumpy ai` command.
+
+The canonical `add-change` skill now lives at the repo root (`skills/`) as a single source of truth and is synced into the package on `build`/`prepack` (gitignored copy), so it ships version-pinned in the npm tarball and via the Claude Code plugin (`claude plugin install @varlock/bumpy`).
+
+The `bumpy ai setup` command has been removed. Its file-copying targets (`opencode`, `cursor`, `codex`) duplicated the skill into tool-specific directories that drifted from the canonical copy — and had silently been broken in the published package — while the `claude` target was a thin wrapper around `claude plugin install`. Install the skill via the Claude Code plugin, or reference the bundled `SKILL.md` directly from `node_modules/@varlock/bumpy/skills/add-change/SKILL.md`.

README.md

@@ -102,15 +102,16 @@ bumpy publish   # pack and publish, create git tags, push tags, and create GitHu
 
 ## AI Integration
 
-Bumpy ships with an AI skill that teaches LLMs how to create bump files.
+Bumpy ships with an [agent skill](https://github.com/dmno-dev/bumpy/blob/main/skills/add-change/SKILL.md) that teaches LLMs how to create bump files.
+
+For Claude Code, install it as a plugin:
 
 ```bash
-bumpy ai setup --target claude    # installs Claude Code plugin
-bumpy ai setup --target opencode  # creates OpenCode command file
-bumpy ai setup --target cursor    # creates Cursor rule file
-bumpy ai setup --target codex     # creates Codex instruction file
+claude plugin install @varlock/bumpy
 ```
 
+The skill is also bundled in the published npm package, so once bumpy is installed it lives at `node_modules/@varlock/bumpy/skills/add-change/SKILL.md` — version-pinned to your installed bumpy. Agents and tools that support the [SKILL.md](https://github.com/dmno-dev/bumpy/blob/main/skills/add-change/SKILL.md) format can reference it directly.
+
 The skill teaches the AI to examine git changes, identify affected packages, choose bump levels, and create bump files with `bumpy add`. It also instructs the AI to keep existing bump files up to date as work continues on a branch - updating packages, bump levels, and summaries to reflect the final state of changes.
 
 ## Documentation

docs/cli.md

@@ -263,20 +263,3 @@ Interactive guide to set up `BUMPY_GH_TOKEN` for CI. Walks through creating a fi
 ```bash
 bumpy ci setup
 ```
-
-## `bumpy ai setup`
-
-Install an AI skill for creating bump files in supported coding tools.
-
-```bash
-bumpy ai setup --target claude
-bumpy ai setup --target opencode
-bumpy ai setup --target cursor
-bumpy ai setup --target codex
-```
-
-| Flag              | Description                                |
-| ----------------- | ------------------------------------------ |
-| `--target <tool>` | `claude`, `opencode`, `cursor`, or `codex` |
-
-For Claude Code, this runs `claude plugin install @varlock/bumpy` under the hood. For other targets, it copies a command/rule file into your project.

packages/bumpy/.gitignore

@@ -0,0 +1,2 @@
+dist
+skills

packages/bumpy/package.json

@@ -36,8 +36,9 @@
     }
   },
   "scripts": {
-    "build": "tsdown",
-    "prepack": "cp ../../README.md .",
+    "build": "bun run scripts/sync-skill.ts && tsdown",
+    "prepack": "bun run scripts/sync-skill.ts && cp ../../README.md .",
+    "sync-skill": "bun run scripts/sync-skill.ts",
     "check": "bun run tsc --noEmit",
     "test": "bun test"
   },

packages/bumpy/scripts/sync-skill.ts

@@ -0,0 +1,27 @@
+/**
+ * Copies the canonical agent skill from the repo root (`skills/`) into this
+ * package so it ships inside the published npm tarball. The skill then travels
+ * with the installed bumpy version, letting agents discover version-pinned
+ * guidance straight from `node_modules` (no separate install / registry).
+ *
+ * The canonical copy lives at the repo root so a single source of truth feeds
+ * both the npm bundle and any future discovery endpoints. This package copy is
+ * a generated artifact (gitignored) and is regenerated on every `build` /
+ * `prepack` / publish. It is also what the Claude Code plugin manifest
+ * (`.claude-plugin/plugin.json`) ships to agents.
+ */
+import { existsSync, rmSync, cpSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const PKG_DIR = resolve(import.meta.dir, '..');
+const SRC = resolve(PKG_DIR, '../../skills');
+const DEST = resolve(PKG_DIR, 'skills');
+
+if (!existsSync(SRC)) {
+  throw new Error(`[sync-skill] canonical skills dir not found at ${SRC}`);
+}
+
+rmSync(DEST, { recursive: true, force: true });
+cpSync(SRC, DEST, { recursive: true });
+
+console.log(`[sync-skill] copied ${SRC} -> ${DEST}`);

packages/bumpy/src/cli.ts

@@ -162,23 +162,6 @@ async function main() {
         break;
       }
 
-      case 'ai': {
-        const rootDir = await findRoot();
-        const subcommand = args[1];
-        const aiFlags = parseFlags(args.slice(2));
-
-        if (subcommand === 'setup') {
-          const { aiSetupCommand } = await import('./commands/ai.ts');
-          await aiSetupCommand(rootDir, {
-            target: aiFlags.target as string | undefined,
-          });
-        } else {
-          log.error(`Unknown ai subcommand: ${subcommand}. Use "ai setup".`);
-          process.exit(1);
-        }
-        break;
-      }
-
       case '--version':
       case '-v':
         console.log(`bumpy ${__BUMPY_VERSION__}`);
@@ -228,7 +211,6 @@ function printHelp() {
     ci plan                 Report what ci release would do (JSON + GitHub Actions outputs)
     ci release              Release — create version PR or auto-publish
     ci setup                Set up a token for triggering CI on version PRs
-    ai setup                Install AI skill for creating bump files
 
   Add options:
     --packages <list>       Package bumps (e.g., "pkg-a:minor,pkg-b:patch")
@@ -271,9 +253,6 @@ function printHelp() {
     --tag <tag>             npm dist-tag for auto-publish
     --branch <name>         Branch name for version PR (default: bumpy/version-packages)
 
-  AI setup options:
-    --target <tool>         Target AI tool: claude, opencode, cursor, codex
-
   ${colorize('https://bumpy.varlock.dev', 'dim')}
 `);
 }