setup-github
このテンプレートから作ったリポジトリの GitHub 側を gh で設定する。Actions の secrets、Actions による PR 作成の許可、PR を作れる人の制限と auto-merge、既定ブランチのルールセットを揃える。テンプレートから新しいリポジトリを作ったとき、GitHub の設定を揃え直すときに使う。
How do I install this agent skill?
npx skills add https://github.com/masseater/skills --skill setup-githubIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions for standard GitHub repository configuration using the GitHub CLI, including setting repository secrets and branch protection rules.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
GitHub の設定
設定はすべて gh で行う。対象リポジトリを REPO=<owner>/<name> とする。
どの手順も、同じ値で何度実行しても結果が変わらない。
1. アプリ名を変える
apps/web/app-name.ts の APP_NAME は、テンプレートの名前のままになっている。
APP_NAME はスタック名とリソース名の接頭辞になる。
状態は Cloudflare アカウントの中でスタック名ごとに保存されるため、同じアカウントを使う別のリポジトリと名前が重なると、互いのリソースを置き換えてしまう。
リポジトリ名に合わせて変える。
2. secrets を登録する
値はユーザーに尋ねる。
gh secret set OPENROUTER_API_KEY --repo "$REPO"
gh secret set CLAUDE_CODE_OAUTH_TOKEN --repo "$REPO"
gh secret set CLOUDFLARE_ACCOUNT_ID --repo "$REPO"
gh secret set CLOUDFLARE_API_TOKEN --repo "$REPO"
| 名前 | 用途 |
|---|---|
OPENROUTER_API_KEY | verify ワークフローの oxlint-plugin-decision |
CLAUDE_CODE_OAUTH_TOKEN | verify 失敗時に Claude Code が自動修正する |
CLOUDFLARE_ACCOUNT_ID | デプロイ先と Alchemy の状態を置くアカウント |
CLOUDFLARE_API_TOKEN | 同じアカウントの API トークン |
Organization のリポジトリなら、Organization の secrets に一度登録すれば、各リポジトリでの登録は要らない。
3. Actions に PR の作成を許可する
release-please と自動修正が PR を作るためである。
gh api --method PUT "repos/$REPO/actions/permissions/workflow" \
-f default_workflow_permissions=read -F can_approve_pull_request_reviews=true
4. PR を作れる人を collaborator に限り、auto-merge を有効にする
gh api --method PATCH "repos/$REPO" -f pull_request_creation_policy=collaborators_only \
-F allow_auto_merge=true -F allow_update_branch=true
5. 既定ブランチを保護する
既定ブランチの削除と force push を禁じ、最新の既定ブランチを取り込んでいない PR のマージを拒むルールセットを置く。
取り込みの検査は、up-to-date ワークフローのチェックを必須にし、strict_required_status_checks_policy を有効にして行う。
バイパスは置かない。release-please の PR は、Claude が既定ブランチを取り込んで push し、そこで動いた up-to-date を通してからマージする。
同じ名前のルールセットがあれば置き換える。
id="$(gh api "repos/$REPO/rulesets" --jq '.[] | select(.name == "protect default branch") | .id')"
gh api --method "$([ -n "$id" ] && echo PUT || echo POST)" "repos/$REPO/rulesets${id:+/$id}" --input - <<'JSON'
{
"name": "protect default branch",
"target": "branch",
"enforcement": "active",
"conditions": { "ref_name": { "include": ["~DEFAULT_BRANCH"], "exclude": [] } },
"bypass_actors": [],
"rules": [
{ "type": "deletion" },
{ "type": "non_fast_forward" },
{
"type": "required_status_checks",
"parameters": {
"strict_required_status_checks_policy": true,
"do_not_enforce_on_create": false,
"required_status_checks": [{ "context": "up-to-date", "integration_id": 15368 }]
}
}
]
}
JSON
6. 反映を確かめる
gh api "repos/$REPO" --jq '[.pull_request_creation_policy, .allow_auto_merge]' が ["collaborators_only",true] を返すことを確かめる。
gh api "repos/$REPO/rules/branches/main" --jq '[.[].type]' に required_status_checks があることも確かめる。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/masseater/skills/setup-github">View setup-github on skillZs</a>