GitHub

Patterns for working with GitHub: CLI usage, issue management, pull requests, Actions CI, publishing to GitHub Packages and Pages. Each sub-file covers a distinct aspect of the GitHub platform.

Topics

• Begin Work: Craft a prompt that gives an agent everything it needs to start or continue work on a GitHub issue. Use when delegating issue work to an agent in a worktree.
• GitHub CLI and Repository Patterns: Core gh CLI patterns (setup, authentication, cloning, forking, syncing, metadata queries, and releases). Use when managing GitHub repos from the command line.
• CI Browser Tests: GitHub Actions workflow for running Playwright browser tests on every push. Use when adding browser test CI to catch rendering and interaction regressions.
• GitHub Issue Editing: Safe editing of issue bodies and comments via temp files to avoid escaping corruption. Use when editing GitHub issue content via the API.
• GitHub Issues: Run the issue dashboard script to list open issues with their linked PRs, branches, merge status, and worktrees. Use when reviewing open work or deciding what to work on next.
• Publish to GitHub Pages: GitHub Actions workflow that builds, tests, and deploys static sites on every push to main. Use when automating deployment to GitHub Pages.
• PR Review Comments: Run the PR comments script to fetch all review threads on a pull request via GraphQL. Use when addressing review feedback to ensure no comments are missed.
• Pull Request Workflow: Full PR lifecycle (creation, review comments, feedback resolution, and merge verification). Use when creating or reviewing pull requests.
• Version on merge: Automate package bump/tag/publish on merges to main using a surface-diff baseline. Use when maintaining release automation for a package.
• GitHub Workflow: Four-phase development process (plan, implement, review, merge). Use when starting a new feature or fix with reviewer collaboration.

See also

• Coding Agents: Setup, settings, permissions, and environment for Claude Code and other AI coding agents.
• Collect Secrets: Pass a secret to a GitHub repo secret (or Worker secret / .dev.vars) without leaking it.
• Update AI Agent CLIs: Update Claude, Codex, Copilot, Antigravity, and Pi CLI tools to their latest versions.
• Git: Core git patterns for committing, branching, worktrees, and conflict resolution.
• Publish to GitHub Packages: GitHub Actions workflow that publishes npm packages on version tags. (Moved to the nodejs skill.)