diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 8ea5aec..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", @@ -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..970642f 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).", + "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", "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.