From 290c258ef734a02dc005d712a6f3583f91560a64 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 8 Sep 2026 06:10:30 +0000 Subject: [PATCH] docs(skills): recommend the per-agent install that lands the bundle once MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The catalog front page recommended `--all`, which the skills CLI expands to `--skill '*' --agent '*' -y`. Measured against skills@1.5.23 with this catalog in an empty directory, that writes the bundle to THREE destinations: a full real copy in `.agents/` (46 files) AND in `agent/` (46 files, re-serialized frontmatter, same bodies), plus 11 `.claude/` symlinks into `.agents/`. The per-agent form lands 46 real files in `.claude/` and nothing else. Line 9 now recommends the per-agent form — the same command the scaffolder already runs (`packages/create-objectstack/src/skills-install.ts`), so the front page and the scaffolder no longer disagree. `--all` is retained as an explicitly-labelled multi-runtime opt-in with its three-destination cost stated rather than merely mentioned. The `/skills` subpath is preserved in the one catalog spelling the file carries: it is the boundary that keeps `metadata.internal` skills out, and `packages/create-objectstack/src/template-consistency.test.ts` ratchets it across `skills/**`. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01P58euzUXCVJNwmhuPC9DXY --- skills/README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/skills/README.md b/skills/README.md index e725d5967f..e274f0d5bb 100644 --- a/skills/README.md +++ b/skills/README.md @@ -6,9 +6,17 @@ working in **any ObjectStack app** — this monorepo *and* third-party projects. projects add (or update) the bundle with: ```bash -npx skills add objectstack-ai/objectstack/skills --all +npx skills add objectstack-ai/objectstack/skills --skill '*' --agent claude-code -y ``` +Name your own runtime after `--agent` (`codex`, `cursor`, …) — the bundle is +byte-identical whichever you name, and it lands **once**, in that agent's own +directory (`.claude/skills/` for `claude-code`). Replacing +`--skill '*' --agent claude-code -y` with `--all` is the multi-runtime opt-in: +it installs for every runtime the CLI knows and writes the bundle to **three** +destinations instead of one — a full real copy in **both** `.agents/` and +`agent/`, plus `.claude/` symlinks pointing into `.agents/`. + The `/skills` subpath matters: it is the published catalog boundary — pointing the skills CLI at the repo root would also pick up repo-internal skills.