@proggarapsody/bitbottle 1.13.0 → 1.14.0

package/README.md

@@ -26,13 +26,18 @@ $ bitbottle pr create --title "fix: handle empty diff" --base main
 npm install -g @proggarapsody/bitbottle
 ```
 
-This also registers the bundled AI agent skill (`SKILL.md`) with any
-agent runtimes detected on your machine — Claude Code, Cursor, Codex,
-Gemini CLI, and 50+ others — so your agents know how to drive bitbottle
-correctly. Skip with `BITBOTTLE_SKIP_SKILL_INSTALL=1 npm install -g …`.
-Install or refresh manually:
+This also registers the bundled AI agent skill (`SKILL.md` + topic
+references) with any agent runtimes detected on your machine —
+Claude Code, Cursor, Codex, Gemini CLI, and 50+ others — so your
+agents know how to drive bitbottle correctly. Skip with
+`BITBOTTLE_SKIP_SKILL_INSTALL=1 npm install -g …`.
+
+If you installed via Homebrew, Go install, or the bare binary,
+register the skill explicitly:
 ```bash
-npx -y skills add proggarapsody/bitbottle --global -y
+bitbottle skill install            # uses npx; needs Node.js >= 18
+bitbottle skill path               # show where the skill was installed
+bitbottle skill remove             # uninstall
 ```
 
 **Go install:**

package/install.js

@@ -115,15 +115,21 @@ function installSkill() {
   }
 
   console.log("Registering bitbottle agent skill (Claude Code, Cursor, Codex, …)…");
+  const env = { ...process.env, npm_config_yes: "true" };
+  const skillsCmd = (cmd) =>
+    execSync(cmd, { stdio: "ignore", timeout: 60_000, env });
   try {
-    execSync(
-      "npx -y skills add proggarapsody/bitbottle --global -y",
-      {
-        stdio: "ignore",
-        timeout: 60_000,
-        env: { ...process.env, npm_config_yes: "true" },
-      }
-    );
+    // Remove first so reinstalls actually pick up new SKILL.md content.
+    // `skills add` is idempotent and skips when the skill already exists,
+    // which means a fresh `npm i -g` after a release would NOT refresh
+    // the skill — defeating the whole point of postinstall. Removing
+    // first guarantees `add` writes the latest content.
+    try {
+      skillsCmd("npx -y skills remove bitbottle -g -y");
+    } catch (_) {
+      // not installed yet; that's fine
+    }
+    skillsCmd("npx -y skills add proggarapsody/bitbottle --global -y");
     console.log(
       "Agent skill registered. Set BITBOTTLE_SKIP_SKILL_INSTALL=1 to disable on next install."
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proggarapsody/bitbottle",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Bitbucket CLI for Server/Data Center and Cloud — npm wrapper for bitbottle",
   "keywords": [
     "mcp",