GitHub Docs リファレンス
GitHub 公式ドキュメント (docs.github.com) の主要セクションを網羅したスキル。
出典: docs.github.com Article Body API (free-pro-team@latest)、取得日 2026-10-17。REST は X-GitHub-Api-Version 2026-03-10 で記述（ヘッダー省略時の既定は 2022-11-28）。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。
ディレクトリ構成
skills/github-docs/
SKILL.md
references/
actions/
README.md
artifact-attestations.md
artifacts.md
caching.md
composite-actions.md
concurrency.md
contexts.md
environment-variables.md
events-triggers.md
expressions.md
limits.md
lockfiles.md
oidc.md
permissions.md
reusable-workflows.md
runners.md
secrets.md
workflow-commands.md
workflow-syntax.md
creating-actions/
README.md
action-metadata.md
docker-actions.md
immutable-releases.md
javascript-actions.md
apps/
README.md
about.md
authentication.md
creating.md
installation.md
oauth-apps.md
permissions-events.md
webhooks.md
authentication/
README.md
deploy-keys.md
personal-access-tokens.md
saml-sso.md
ssh-keys.md
two-factor-auth.md
cli/
README.md
extensions.md
quickstart.md
reference.md
graphql/
README.md
forming-calls.md
overview.md
pagination.md
rate-limits.md
schema-reference.md
pages/
README.md
configuration.md
custom-domains.md
getting-started.md
projects/
README.md
graphql-api.md
rest-api.md
pull-requests/
README.md
code-owners.md
conflicts.md
creating.md
merging.md
reviewing.md
repositories/
README.md
branches.md
creating-managing.md
files.md
releases-tags.md
settings.md
templates.md
rest-api/
README.md
agent-tasks/
README.md
agent-tasks.md
agents/
README.md
secrets.md
variables.md
billing/
README.md
budgets.md
usage.md
campaigns/
README.md
campaigns.md
actions/
README.md
artifacts.md
cache.md
concurrency-groups.md
oidc.md
secrets.md
self-hosted-runners.md
variables.md
workflow-jobs.md
workflow-runs.md
workflows.md
activity/
events.md
notifications.md
starring.md
watching.md
checks/
README.md
check-runs.md
check-suites.md
codespaces/
codespaces.md
copilot/
README.md
cloud-agent-management.md
coding-agent-management.md
content-exclusion-management.md
spaces.md
usage-metrics.md
user-management.md
dependency-graph/
README.md
dependency-review.md
dependency-submission.md
sboms.md
deployments/
README.md
deployments.md
environments.md
gists/
README.md
gists.md
git/
README.md
blobs.md
commits.md
refs.md
tags.md
trees.md
issues/
README.md
assignees.md
comments.md
issues.md
labels.md
milestones.md
orgs/
README.md
orgs.md
overview/
about.md
api-versions.md
authentication.md
best-practices.md
pagination.md
permissions.md
rate-limits.md
troubleshooting.md
packages/
README.md
packages.md
pages/
README.md
pages.md
projects/
fields.md
items.md
projects.md
pulls/
README.md
pulls.md
review-comments.md
review-requests.md
reviews.md
repos/
README.md
branches.md
collaborators.md
commits.md
contents.md
deploy-keys.md
releases.md
repos.md
tags.md
webhooks.md
search/
README.md
search.md
security/
README.md
code-scanning.md
dependabot-alerts.md
dependabot-repository-access.md
dependabot-secrets.md
secret-scanning.md
secret-scanning-push-protection.md
teams/
README.md
members.md
teams.md
users/
README.md
users.md
webhooks/
README.md
about.md
best-practices.md
creating.md
events.md
securing.md
samples/
README.md
cache-dependencies.md
ci-node.md
composite-action.md
concurrency-deploy-queue.md
deploy-on-push.md
manual-dispatch.md
matrix-build.md
oidc-aws-deploy.md
pr-auto-comment.md
rest-api-call.md
reusable-workflow-deploy.md
scheduled-workflow.md
secret-usage.md
scripts/
README.md
api.md
auth.md
cli.md
extensions.md
generate.md
install.md
探索手順
タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの
references/{category}/README.mdを参照して目的のページを特定する - 該当ページの
.mdを Read して詳細を確認する
samples 利用時の安全規約
samples/ のサンプルはそのまま複製されて消費側リポジトリの CI になる前提の資材である。複製時に危険な書き方が伝播しないよう、全サンプルは以下を満たす。
- 外部 action・別リポジトリの reusable workflow はコミット SHA 固定で参照する（末尾コメントでバージョンを示す）。
@v4/@mainなどの可動 ref は付け替え可能でサプライチェーン攻撃の経路になる ${{ ... }}をrun:本文やactions/github-scriptのscript:本文へ直接展開しない。env:へ渡し、シェルでは"${VAR}"、JavaScript ではprocess.env.VARで参照する- ジョブの
permissionsは必要最小限を明示する。既定権限が read-only のリポジトリでも動くようにする - 各
run:は複数行ブロック（run: |）とし、先頭にset -euo pipefailを置く。ワークフロー側のステップにもshell: bashを明示する。未定義変数やパイプ途中の失敗を見逃さないため $GITHUB_OUTPUTなどの環境変数は"${GITHUB_OUTPUT}"とクォートして参照する- fork PR を扱う場合、
pull_request_targetへ単純置換しない。PR のコードを実行しないジョブへ分離する（samples/pr-auto-comment.md参照）
タスク → カテゴリ マッピング
| タスク | カテゴリ | 参照 README |
|---|---|---|
| ワークフロー構文・CI/CD 設定、イベントトリガー、シークレット、キャッシュ、アーティファクト | actions | references/actions/README.md |
| ワークフローコマンド（::add-mask:: / GITHUB_OUTPUT / ジョブサマリー）、concurrency と queue、Actions の制限値 | actions | references/actions/README.md |
| OIDC クラウド連携（id-token）、lockfile（gh actions-lock）、artifact attestations | actions | references/actions/README.md |
| カスタムアクション作成（JavaScript・Docker・複合アクション）、immutable releases | actions/creating-actions | references/actions/creating-actions/README.md |
| GitHub App 作成・認証・インストール、OAuth Apps との比較 | apps | references/apps/README.md |
| SSH キー・PAT・2FA・SAML SSO・デプロイキー | authentication | references/authentication/README.md |
| gh コマンド、CLI クイックスタート、CLI 拡張機能 | cli | references/cli/README.md |
| GraphQL クエリ・ミューテーション・スキーマ・ページネーション | graphql | references/graphql/README.md |
| GitHub Pages 作成・設定・カスタムドメイン | pages | references/pages/README.md |
| GitHub Projects（v2）の GraphQL / REST API 操作 | projects | references/projects/README.md |
| PR 作成・レビュー・マージ、CODEOWNERS、コンフリクト解決 | pull-requests | references/pull-requests/README.md |
| リポジトリ作成・設定、ブランチ保護、リリース・タグ管理 | repositories | references/repositories/README.md |
| REST API 概要・認証・レート制限・ページネーション | rest-api/overview | references/rest-api/README.md |
| Actions API（ワークフロー・シークレット・アーティファクト等） | rest-api/actions | references/rest-api/actions/README.md |
| アクティビティ API（イベント・通知・スター・ウォッチ） | rest-api/activity | references/rest-api/README.md |
| チェック API（check-runs・check-suites） | rest-api/checks | references/rest-api/checks/README.md |
| Codespaces API | rest-api/codespaces | references/rest-api/README.md |
| Copilot API（利用状況メトリクス・ユーザー管理・Spaces・cloud agent 管理・content exclusion） | rest-api/copilot | references/rest-api/copilot/README.md |
| Dependency graph API（dependency review / submission / SBOM） | rest-api/dependency-graph | references/rest-api/dependency-graph/README.md |
| Agent tasks API（Copilot cloud agent タスク） | rest-api/agent-tasks | references/rest-api/agent-tasks/README.md |
| Agents secrets / variables API | rest-api/agents | references/rest-api/agents/README.md |
| Security campaigns API | rest-api/campaigns | references/rest-api/campaigns/README.md |
| Teams API（チーム・メンバー） | rest-api/teams | references/rest-api/teams/README.md |
| Billing API（budgets / usage） | rest-api/billing | references/rest-api/billing/README.md |
| デプロイ・環境 API | rest-api/deployments | references/rest-api/deployments/README.md |
| Gist API | rest-api/gists | references/rest-api/gists/README.md |
| Git データ API（blobs・commits・refs・tags・trees） | rest-api/git | references/rest-api/git/README.md |
| Issue API（ラベル・マイルストーン・コメント・担当者） | rest-api/issues | references/rest-api/issues/README.md |
| Organization API | rest-api/orgs | references/rest-api/orgs/README.md |
| パッケージ API | rest-api/packages | references/rest-api/packages/README.md |
| Pages API | rest-api/pages | references/rest-api/pages/README.md |
| Projects（v2）REST API（items・fields） | rest-api/projects | references/rest-api/README.md |
| PR API（レビュー・レビューコメント・レビューリクエスト） | rest-api/pulls | references/rest-api/pulls/README.md |
| リポジトリ API（ブランチ・コンテンツ・リリース・Webhook） | rest-api/repos | references/rest-api/repos/README.md |
| 検索 API | rest-api/search | references/rest-api/search/README.md |
| セキュリティ API（code scanning・secret scanning・Dependabot alerts/secrets/repository access） | rest-api/security | references/rest-api/security/README.md |
| ユーザー API | rest-api/users | references/rest-api/users/README.md |
| Webhook 作成・イベントペイロード・セキュリティ・ベストプラクティス | webhooks | references/webhooks/README.md |
| 典型的な Actions ワークフロー・デプロイ・CI パターンを知りたい | samples | samples/README.md |
| gh CLI インストール・認証・API 呼び出しコマンドを知りたい | scripts | scripts/README.md |