Jeremy Daer
0cd0a040bf
* Fix link to Basecamp CLI install guide * Reposition as agent skills for all 37signals products This repo publishes the agent skills of Basecamp, HEY, and Fizzy, but the README, install guide, and AGENTS.md still described it as Basecamp-only. README: name all three products, list every skill with the product and the CLI repo it is published from, and say where the hey and fizzy skills are until they land here (hey is absent because of the shared-manifest sync bug in #5; fizzy-cli has no skills sync yet). Requirements per product use each CLI's documented installer and auth command; the Homebrew cask is basecamp/tap/basecamp-cli, not basecamp/tap/basecamp, which does not exist. install.md: restructured per the install-md spec so an agent installs the Basecamp CLI (required) and the HEY and Fizzy CLIs only for the products the user has, with a verify step per product and a DONE WHEN that holds when only one CLI is installed. Points at the lowercase basecamp-cli install.md. AGENTS.md: describe the multi-source layout, the per-source manifests each sync owns and the legacy .managed-skills tombstone, and the rule that skills are edited upstream in each CLI's skills/ directory. * Describe all 37signals products in the plugin manifest, version 0.2.0 The plugin and marketplace descriptions said Basecamp only. Name Basecamp, HEY, and Fizzy, and bump the version. The plugin name stays basecamp-skills so existing installs keep resolving. * Test the authenticated flag, since auth status exits 0 when signed out All three CLIs' auth status commands return their OK envelope whether or not you are signed in (basecamp-cli app.OK, hey-cli writeOK, fizzy-cli printDetail), so a bare `auth status` in the DONE WHEN and the verify steps never failed. Test the JSON envelope's "authenticated": true instead, with --json so the shape does not depend on a TTY. Each CLI pretty-prints with a two-space indent, so that literal is exact. * Point at the proposed fizzy-cli skills sync * Make each product optional in install.md and install the absent skills from their CLIs * Say which skills the plugin bundles today The plugin description named Basecamp, HEY and Fizzy as though all three were packaged, while skills/ holds only the Basecamp ones until the hey-cli and fizzy-cli syncs publish here. Keep the 37signals scope and state what installs now, in plugin.json and the matching marketplace plugin entry. * Stop when the products you chose are signed in, not every CLI on PATH The completion predicate required every product CLI found on PATH to be signed in, so a machine with an unused, unauthenticated hey or fizzy binary could never finish a Basecamp-only run — or worse, sent the agent to sign in to a product the user did not choose. Completion now follows the TODO: each chosen product's auth status must report authenticated, at least one, and a CLI for a product that was not chosen is left alone. * Install the hey and fizzy skills even when their CLIs were already installed Steps 2 and 3 told the reader to skip the installer when the CLI was present, but the only `skill install` command sat behind that installer in one && chain, so a machine that already had the CLI could finish the run without the selected product's skill. Each step is now three lines that stand alone: the installer runs only when the CLI is missing, sign-in only when not already signed in, and the skill install every time. --------- Co-authored-by: Jeff <142809588+ksp-jjensen@users.noreply.github.com>
4.5 KiB
Agent Skills for 37signals products
Agent skills for Basecamp, HEY, and Fizzy. Each skill teaches a coding agent to work in one product through that product's CLI.
npx skills add basecamp/skills
That installs every skill in skills/. See install.md for the
full setup, including installing and authenticating each CLI.
Skills
| Skill | Product | Published from | Description |
|---|---|---|---|
| basecamp | Basecamp | basecamp-cli | 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 | Basecamp | basecamp-cli | Diagnose Basecamp CLI, authentication, and agent-plugin health. |
| hey | HEY | hey-cli | 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). |
| fizzy | Fizzy | fizzy-cli | 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): 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,
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; once it ships,
the skill arrives with the next fizzy-cli release.
Get it from
fizzy-cli/skills/fizzy,
or run fizzy skill install.
Requirements
Each skill drives its product's CLI, so install and authenticate the CLI for the products you use. One is enough; the skills for the others sit idle.
Basecamp — basecamp-cli (install guide)
curl -fsSL https://basecamp.com/install-cli | bash # or: brew install --cask basecamp/tap/basecamp-cli
basecamp auth login
HEY — hey-cli (install guide)
curl -fsSL https://hey.com/install-cli | bash # or: brew install --cask basecamp/tap/hey
hey auth login
Fizzy — fizzy-cli (install guide)
curl -fsSL https://raw.githubusercontent.com/basecamp/fizzy-cli/master/scripts/install.sh | bash # or: brew install --cask basecamp/tap/fizzy
fizzy setup # personal access token, account, default board
Contributing
Skills are never edited in this repo; a change made here is overwritten by the next release of the CLI that owns it. Open issues and pull requests against the skill's source instead:
- Basecamp: basecamp-cli/skills
- HEY: hey-cli/skills
- Fizzy: fizzy-cli/skills
Issues about this repo itself (the README, install.md, the plugin manifest, or the publishing) belong here.
About
This repo is a publish target. On each release, a CLI's scripts/sync-skills.sh
copies its skills/ tree into skills/ here, records the directories it owns
in a manifest, and commits straight to main. Only the README, install.md,
AGENTS.md, and .claude-plugin/ are written by hand.