Repository navigation
Reposition as agent skills for all 37signals products #6
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
6b68ece
Fix link to Basecamp CLI install guide
ksp-jjensen 5e04622
Reposition as agent skills for all 37signals products
jeremy 9ee30e1
Describe all 37signals products in the plugin manifest, version 0.2.0
jeremy 1a391c7
Test the authenticated flag, since auth status exits 0 when signed out
jeremy 64fea17
Point at the proposed fizzy-cli skills sync
jeremy 7e38071
Make each product optional in install.md and install the absent skill…
jeremy 18ad514
Say which skills the plugin bundles today
jeremy 9ccefba
Stop when the products you chose are signed in, not every CLI on PATH
jeremy 8217f55
Install the hey and fizzy skills even when their CLIs were already in…
jeremy File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,25 +1,49 @@ | ||
| # Basecamp Skills Repo | ||
| # 37signals Skills Repo | ||
|
|
||
| Distribution repo for Basecamp skills for Claude Code. Skills are auto-synced | ||
| from [basecamp/basecamp-cli](https://github.com/basecamp/basecamp-cli) on each | ||
| release by `scripts/sync-skills.sh`. | ||
| Publish target for the agent skills of 37signals products: Basecamp, HEY, and | ||
| Fizzy. Each product's CLI mirrors its `skills/` tree into `skills/` here on | ||
| release, via that CLI's `scripts/sync-skills.sh`. Nothing under `skills/` is | ||
| written by hand. | ||
|
|
||
| For installation, see [install.md](install.md). | ||
|
|
||
| ## Sources | ||
|
|
||
| | 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) | | ||
|
|
||
| ## Key constraints | ||
|
|
||
| - **Do not edit skills here.** Edit in `basecamp-cli/skills/` and let the sync | ||
| publish them. Manual edits will be overwritten on the next release. | ||
| - `.managed-skills` tracks which skill directories are owned by the sync script. | ||
| Don't edit it manually. | ||
| - Non-skill files (README, AGENTS.md, install.md, .claude-plugin/) are safe to | ||
| edit directly — the sync only touches `skills/` and `.managed-skills`. | ||
| - **Do not edit skills here.** Edit them in the CLI repo that owns them | ||
| (`basecamp-cli/skills/`, `hey-cli/skills/`, `fizzy-cli/skills/`) and let the | ||
| next release publish them. Manual edits here are overwritten by that release. | ||
| - **Manifests are per source, and owned by the sync scripts.** | ||
| `.managed-skills.basecamp-cli` and `.managed-skills.hey-cli` (and | ||
| `.managed-skills.fizzy-cli` once Fizzy publishes) each list the skill | ||
| directories that source's sync owns. A sync only ever deletes directories | ||
| listed in its own file, so one product's release cannot remove another's | ||
| skills. The legacy shared `.managed-skills` is kept as a comment-only | ||
| tombstone so a CLI still running the old script deletes nothing. Don't edit | ||
| any of these manually. | ||
| - **Safe to edit directly:** `README.md`, `AGENTS.md`, `install.md`, and | ||
| `.claude-plugin/`. The sync only touches `skills/` and its own manifest. | ||
|
|
||
| ## Repo structure | ||
|
|
||
| ``` | ||
| .claude-plugin/ # Plugin manifest for marketplace install | ||
| .claude-plugin/ # Plugin manifest for marketplace install | ||
| skills/ | ||
| basecamp/SKILL.md # Synced from basecamp-cli | ||
| .managed-skills # Auto-generated manifest | ||
| 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) | ||
| .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. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,27 +1,86 @@ | ||
| # Agent Skills for Basecamp | ||
| # Agent Skills for 37signals products | ||
|
|
||
| [Agent skills](https://agentskills.io) for Basecamp project management — | ||
| todos, cards, messages, schedule, campfire, and more. | ||
| [Agent skills](https://agentskills.io) 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 | ||
| ``` | ||
|
|
||
| See [install.md](install.md) for full setup instructions including CLI authentication. | ||
| That installs every skill in `skills/`. See [install.md](install.md) for the | ||
| full setup, including installing and authenticating each CLI. | ||
|
|
||
| ## Available skills | ||
| ## Skills | ||
|
|
||
| | Skill | Description | | ||
| |-------|-------------| | ||
| | [basecamp](skills/basecamp/SKILL.md) | Full Basecamp CLI integration — todos, cards, messages, files, schedule, check-ins, timeline, recordings, templates, webhooks, subscriptions, lineup, and campfire. | | ||
| | Skill | Product | Published from | Description | | ||
| |-------|---------|----------------|-------------| | ||
| | [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). | | ||
| | 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). | | ||
|
|
||
| ## Requires | ||
| **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. | ||
|
|
||
| - [Basecamp CLI](https://github.com/basecamp/basecamp-cli) (see [install instructions](https://github.com/basecamp/basecamp-cli#installation)) | ||
| - An authenticated Basecamp account (`basecamp auth login`) | ||
| **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-cli/skills/fizzy](https://github.com/basecamp/fizzy-cli/tree/master/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](https://github.com/basecamp/basecamp-cli) | ||
| ([install guide](https://github.com/basecamp/basecamp-cli/blob/main/install.md)) | ||
|
|
||
| ```bash | ||
| curl -fsSL https://basecamp.com/install-cli | bash # or: brew install --cask basecamp/tap/basecamp-cli | ||
| basecamp auth login | ||
| ``` | ||
|
|
||
| **HEY** — [hey-cli](https://github.com/basecamp/hey-cli) | ||
| ([install guide](https://github.com/basecamp/hey-cli/blob/main/docs/install.md)) | ||
|
|
||
| ```bash | ||
| curl -fsSL https://hey.com/install-cli | bash # or: brew install --cask basecamp/tap/hey | ||
| hey auth login | ||
| ``` | ||
|
|
||
| **Fizzy** — [fizzy-cli](https://github.com/basecamp/fizzy-cli) | ||
| ([install guide](https://github.com/basecamp/fizzy-cli#quick-start)) | ||
|
|
||
| ```bash | ||
| 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](https://github.com/basecamp/basecamp-cli/tree/main/skills) | ||
| - HEY: [hey-cli/skills](https://github.com/basecamp/hey-cli/tree/main/skills) | ||
| - Fizzy: [fizzy-cli/skills](https://github.com/basecamp/fizzy-cli/tree/master/skills) | ||
|
|
||
| Issues about this repo itself (the README, install.md, the plugin manifest, or | ||
| the publishing) belong here. | ||
|
|
||
| ## About | ||
|
|
||
| These skills are automatically published from | ||
| [basecamp/basecamp-cli](https://github.com/basecamp/basecamp-cli) on each | ||
| release. To contribute, open issues or PRs there. | ||
| 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. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.