@davmash/bygone 0.8.3 → 0.8.4

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.8.4
+
+- Clarified PR Tour Guide skill install commands for project scope and agent-specific global installs
+- Documented PromptScript-safe installation (`-y` without bare `-g`) to avoid spurious global-install failures from the skills CLI
+
 ## 0.8.3
 
 - Fixed tour anchor gutter markers so active and persistent anchors are visibly rendered by Monaco, including after switching files in stacked tours

package/README.md

@@ -119,10 +119,14 @@ Packaged macOS builds register `.bygone` with the desktop app, so Finder can ope
 
 Agents can validate anchors and structure with `bygone tour validate <file.bygone> --json`, compile a portable manifest with `bygone tour compile`, and retrieve the authoring contract with `bygone tour schema`. See [Generating change tours with an LLM](./docs/generating-change-tours.md).
 
-Install the agent skill (Cursor, Codex, Claude Code, and other supported agents):
+Install the agent skill:
 
 ```bash
-npx skills add davidmashburn/bygone -s pr-tour-guide -g -y
+# project scope (PromptScript-safe; committed with the repo if you run it here)
+npx skills add davidmashburn/bygone -s pr-tour-guide -y
+
+# global scope — name agents to avoid PromptScript global-install noise
+npx skills add davidmashburn/bygone -s pr-tour-guide -g -y -a cursor codex claude-code
 ```
 
 The skill includes Bygone install instructions for macOS Homebrew, npm, and source checkouts. It also ships inside the `@davmash/bygone` npm package under `skills/pr-tour-guide/`. Source: [`pr-tour-guide` skill](./skills/pr-tour-guide/SKILL.md).

package/docs/generating-change-tours.md

@@ -7,7 +7,11 @@ For agents that support repository skills, use the agent-agnostic [`pr-tour-guid
 Install it with the skills CLI:
 
 ```sh
-npx skills add davidmashburn/bygone -s pr-tour-guide -g -y
+# project scope (works with PromptScript)
+npx skills add davidmashburn/bygone -s pr-tour-guide -y
+
+# global scope — pass -a so PromptScript is not included
+npx skills add davidmashburn/bygone -s pr-tour-guide -g -y -a cursor codex claude-code
 ```
 
 The skill documents how to install Bygone itself when the CLI is missing.

package/out/standalone-main.js

@@ -8798,7 +8798,7 @@ var require_package = __commonJS({
       displayName: "Bygone",
       desktopName: "com.davidmashburn.bygone.desktop",
       description: "See how change happened. Visual diff and file history for VS Code.",
-      version: "0.8.3",
+      version: "0.8.4",
       author: "David Mashburn",
       license: "MIT",
       private: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davmash/bygone",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "See how change happened. Visual diff and file history.",
   "author": "David Mashburn",
   "license": "MIT",

package/skills/pr-tour-guide/SKILL.md

@@ -9,10 +9,28 @@ Use Bygone as the deterministic evidence and rendering layer. Treat the language
 
 ## Install this skill
 
-For Cursor, Codex, Claude Code, and other agents supported by the skills CLI:
+Install with the [skills CLI](https://skills.sh). Prefer **project** scope (default) or name agents explicitly on **global** installs — bare `-g` fans out to every detected host, and PromptScript only supports project-level skills, which produces a spurious failure line.
+
+**This repo / PromptScript / team-shared (project scope):**
+
+```sh
+npx skills add davidmashburn/bygone -s pr-tour-guide -y
+```
+
+Installs to `.agents/skills/pr-tour-guide` (or your agent's project skills directory).
+
+**Global, all projects (pick your agents):**
+
+```sh
+npx skills add davidmashburn/bygone -s pr-tour-guide -g -y -a cursor codex claude-code
+```
+
+Add or remove agent names for the tools you use. Omit `-a` only if you accept PromptScript possibly printing `does not support global skill installation` even when other agents succeeded.
+
+**PromptScript only:**
 
 ```sh
-npx skills add davidmashburn/bygone -s pr-tour-guide -g -y
+npx skills add davidmashburn/bygone -s pr-tour-guide -y -a promptscript
 ```
 
 List without installing:
@@ -24,7 +42,7 @@ npx skills add davidmashburn/bygone --list
 From a Bygone source checkout, install the local copy instead:
 
 ```sh
-npx skills add ./skills/pr-tour-guide -g -y
+npx skills add ./skills/pr-tour-guide -y
 ```
 
 ## Install Bygone