From 43058b6c1010fdb632e27f52f2de0cbf3afc4ed2 Mon Sep 17 00:00:00 2001 From: Rob Zolkos Date: Thu, 22 Oct 2026 17:10:54 -0400 Subject: [PATCH 1/2] Say that hey is published here again The hey-cli v1.10.0 sync (408d225) put skills/hey back, and the per-source manifests from #5's fix have kept it through three basecamp-cli syncs since. The README, AGENTS.md, install.md and the plugin description still said it was missing, and install.md's HEY step installed the skill from the CLI to cover the gap. That would now install hey twice: once from hey-cli into ~/.agents/skills/hey, then again from this repo in Step 4. fizzy-cli#214 has also merged, so fizzy is waiting on fizzy-cli's next release rather than on a proposed sync. --- .claude-plugin/marketplace.json | 2 +- .claude-plugin/plugin.json | 2 +- AGENTS.md | 11 +++++------ README.md | 19 ++++--------------- install.md | 5 ++--- 5 files changed, 13 insertions(+), 26 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 8ea5aec..dab8270 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -12,7 +12,7 @@ "plugins": [ { "name": "basecamp-skills", - "description": "Agent skills for 37signals products, each driving its product's CLI. Bundles the Basecamp skills today; HEY and Fizzy join as their CLIs publish here (see the README).", + "description": "Agent skills for 37signals products, each driving its product's CLI. Bundles the Basecamp and HEY skills today; Fizzy joins when fizzy-cli publishes here (see the README).", "source": "./", "category": "productivity" } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index cb465fa..f12c183 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "basecamp-skills", "version": "0.2.0", - "description": "Agent skills for 37signals products, each driving its product's CLI. Bundles the Basecamp skills today; HEY and Fizzy join as their CLIs publish here (see the README).", + "description": "Agent skills for 37signals products, each driving its product's CLI. Bundles the Basecamp and HEY skills today; Fizzy joins when fizzy-cli publishes here (see the README).", "author": { "name": "37signals", "email": "support@37signals.com" diff --git a/AGENTS.md b/AGENTS.md index 456a609..7173d8c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,8 +12,8 @@ For installation, see [install.md](install.md). | Source | Skills | Publishes here | |--------|--------|----------------| | [basecamp-cli](https://github.com/basecamp/basecamp-cli/tree/main/skills) | `basecamp`, `basecamp-doctor` | On each stable release | -| [hey-cli](https://github.com/basecamp/hey-cli/tree/main/skills) | `hey` | On each stable release. Absent right now: see [#5](https://github.com/basecamp/skills/issues/5) | -| [fizzy-cli](https://github.com/basecamp/fizzy-cli/tree/master/skills) | `fizzy` | Not yet; a release sync is proposed in [fizzy-cli#214](https://github.com/basecamp/fizzy-cli/pull/214) | +| [hey-cli](https://github.com/basecamp/hey-cli/tree/main/skills) | `hey` | On each stable release | +| [fizzy-cli](https://github.com/basecamp/fizzy-cli/tree/master/skills) | `fizzy` | Not yet; the release sync from [fizzy-cli#214](https://github.com/basecamp/fizzy-cli/pull/214) first runs on fizzy-cli's next stable release | ## Key constraints @@ -38,12 +38,11 @@ For installation, see [install.md](install.md). skills/ basecamp/SKILL.md # Synced from basecamp-cli basecamp-doctor/SKILL.md # Synced from basecamp-cli - hey/SKILL.md # Synced from hey-cli (absent until its next release, see #5) + hey/SKILL.md # Synced from hey-cli .managed-skills.basecamp-cli # Skill directories owned by basecamp-cli's sync .managed-skills.hey-cli # Skill directories owned by hey-cli's sync .managed-skills # Legacy shared manifest, comment-only tombstone ``` -The per-source manifests and the tombstone appear with the first release of -each CLI after its sync fix ships; until then the legacy `.managed-skills` is -the only manifest present. +`.managed-skills.fizzy-cli` and `skills/fizzy/` appear with fizzy-cli's first +stable release after its sync landed. diff --git a/README.md b/README.md index 3d852f5..aa6a82f 100644 --- a/README.md +++ b/README.md @@ -16,23 +16,12 @@ full setup, including installing and authenticating each CLI. |-------|---------|----------------|-------------| | [basecamp](skills/basecamp/SKILL.md) | Basecamp | [basecamp-cli](https://github.com/basecamp/basecamp-cli/tree/main/skills/basecamp) | Interact with Basecamp via the Basecamp CLI. Full API coverage: projects, todos, cards, messages, files, schedule, check-ins, timeline, recordings, templates, webhooks, subscriptions, lineup, chat, pings, gauges, assignments, notifications, bookmarks, bubble-up, drafts, notes, calendars, and accounts. | | [basecamp-doctor](skills/basecamp-doctor/SKILL.md) | Basecamp | [basecamp-cli](https://github.com/basecamp/basecamp-cli/tree/main/skills/basecamp-doctor) | Diagnose Basecamp CLI, authentication, and agent-plugin health. | -| hey | HEY | [hey-cli](https://github.com/basecamp/hey-cli/tree/main/skills/hey) | Interact with HEY via the HEY CLI. Read and send email; manage contacts, boxes, labels, collections, calendars, todos, habits, time tracking, and journal entries. **Missing from `skills/` right now** (see below). | +| [hey](skills/hey/SKILL.md) | HEY | [hey-cli](https://github.com/basecamp/hey-cli/tree/main/skills/hey) | Interact with HEY via the HEY CLI. Read and send email; manage contacts, boxes, labels, collections, calendars, todos, habits, time tracking, and journal entries. | | fizzy | Fizzy | [fizzy-cli](https://github.com/basecamp/fizzy-cli/tree/master/skills/fizzy) | Interact with Fizzy via the Fizzy CLI. Manage boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, and account settings. **Not published here yet** (see below). | -**hey** is absent because of a sync bug -([#5](https://github.com/basecamp/skills/issues/5)): the basecamp-cli and -hey-cli release syncs shared one `.managed-skills` manifest, so each product's -release deleted the other product's skills. Fixes are in flight in both CLIs. -The skill returns automatically on the first hey-cli release after that fix -ships. Until then, get it from -[hey-cli/skills/hey](https://github.com/basecamp/hey-cli/tree/main/skills/hey), -or run `hey skill install`, which installs it from the CLI itself. - -**fizzy** is not published here yet: fizzy-cli's release has no skills sync. -One is proposed in -[fizzy-cli#214](https://github.com/basecamp/fizzy-cli/pull/214); once it ships, -the skill arrives with the next fizzy-cli release. -Get it from +**fizzy** is not published here yet: fizzy-cli's release sync landed in +[fizzy-cli#214](https://github.com/basecamp/fizzy-cli/pull/214), and the skill +arrives with the first fizzy-cli release after it. Until then, get it from [fizzy-cli/skills/fizzy](https://github.com/basecamp/fizzy-cli/tree/master/skills/fizzy), or run `fizzy skill install`. diff --git a/install.md b/install.md index 43f9c5d..7451fdb 100644 --- a/install.md +++ b/install.md @@ -42,12 +42,11 @@ basecamp auth status --json | grep -q '"authenticated": true' && echo OK ## Step 2: Install and sign in to HEY CLI -Only if you use HEY; otherwise mark this TODO done and continue. Run all three lines: the first installs the CLI only when `hey` is not already on PATH (see the [HEY CLI install guide](https://github.com/basecamp/hey-cli/blob/main/docs/install.md) for other install methods), the second signs in only when not already signed in (it opens a browser), and the third installs the hey skill from the CLI itself, since it is temporarily missing from this repo (see the [README](README.md)) — it runs even when the CLI was already installed. +Only if you use HEY; otherwise mark this TODO done and continue. Run both lines: the first installs the CLI only when `hey` is not already on PATH (see the [HEY CLI install guide](https://github.com/basecamp/hey-cli/blob/main/docs/install.md) for other install methods), and the second signs in only when not already signed in (it opens a browser). The hey skill installs from this repo in Step 4, with the others. ```bash command -v hey >/dev/null || curl -fsSL https://hey.com/install-cli | bash hey auth status --json | grep -q '"authenticated": true' || hey auth login -hey skill install ``` **Verify:** @@ -83,7 +82,7 @@ npx skills add basecamp/skills **Verify:** ```bash npx skills list -# Expected: basecamp and basecamp-doctor listed (hey too, once it is published here) +# Expected: the basecamp skills and hey listed ``` Restart your agent session to pick up the new skills. From 0fe86515b74f2b6b25ded9cb6c528533ce694fdb Mon Sep 17 00:00:00 2001 From: Rob Zolkos Date: Thu, 22 Oct 2026 17:15:32 -0400 Subject: [PATCH 2/2] Bump the plugin to 0.3.0 so existing installs pick up hey Claude Code re-downloads a plugin only when its version changes, so an install made at 0.2.0 before the hey-cli v1.10.0 sync has no hey skill while the description now says it bundles one. --- .claude-plugin/marketplace.json | 2 +- .claude-plugin/plugin.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index dab8270..b8adea6 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -3,7 +3,7 @@ "name": "basecamp-skills", "metadata": { "description": "Agent skills for 37signals products: Basecamp, HEY, and Fizzy", - "version": "0.2.0" + "version": "0.3.0" }, "owner": { "name": "37signals", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index f12c183..970642f 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "basecamp-skills", - "version": "0.2.0", + "version": "0.3.0", "description": "Agent skills for 37signals products, each driving its product's CLI. Bundles the Basecamp and HEY skills today; Fizzy joins when fizzy-cli publishes here (see the README).", "author": { "name": "37signals",