Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand All @@ -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"
}
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
11 changes: 5 additions & 6 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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.
19 changes: 4 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

Expand Down
5 changes: 2 additions & 3 deletions install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:**
Expand Down Expand Up @@ -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.
Expand Down