Skip to content

Docs: skills-sync App needs Contents + Issues write #59

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.

Sign up for GitHub

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
jeremy merged 1 commit into from
Jul 27, 2026
Merged

Docs: skills-sync App needs Contents + Issues write #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 1 deletion prompts/seed-cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -151,7 +151,7 @@ After the repo is pushed to GitHub:
| macOS notarization | 5 secrets in `release` environment |
| Homebrew tap | `secrets.HOMEBREW_TAP_TOKEN` |
| AUR publish | `secrets.AUR_SSH_KEY` |
| Skills sync | `vars.SKILLS_APP_ID` + `secrets.SKILLS_APP_PRIVATE_KEY` |
| Skills sync | `vars.SKILLS_APP_ID` + `secrets.SKILLS_APP_PRIVATE_KEY` (App installation needs Contents: write + Issues: write on `basecamp/skills`; token creation fails if either is missing) |

All features are off by default and degrade gracefully.

Expand Down
7 changes: 7 additions & 0 deletions seed/RELEASING.md.tmpl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,13 @@ vars are added.
| `SKILLS_APP_ID` (var) | GitHub App ID for skills sync (optional) |
| `SKILLS_APP_PRIVATE_KEY` | GitHub App private key for skills sync (optional) |

The skills-sync App installation must grant **Contents: write** and
**Issues: write** on `basecamp/skills` — the workflow requests both
(`permission-contents` / `permission-issues`), and token creation fails
outright if a requested permission is missing from the installation.
Existing Apps set up with Contents only need the added Issues permission
and the installation update approved before sync works again.

**Environment secrets** (`release` environment — Settings > Environments):

| Secret | Purpose |
Expand Down
Loading