github-ops - SKILL.md Agent Skill

name: github-ops description: GitHub issue, PR, and release operations via gh CLI. Not for code review or release builds. version: 1.1.0 allowed-tools: - Bash - Read

GitHub Operations Skill

Use this skill when working with GitHub issues, PRs, and releases for Pake.

Golden Rule

ALWAYS use gh CLI for GitHub operations. Never use the web UI or make assumptions about state — always query first.

Issue Operations

# View a specific issue
gh issue view 123

# List open issues
gh issue list --state open

# List issues with a label
gh issue list --label bug

# Add a comment (only with explicit user request)
gh issue comment 123 --body "..."

# Close an issue
gh issue close 123

PR Operations

# List open PRs
gh pr list

# View a PR
gh pr view 456

# Check PR status and CI checks
gh pr checks 456

# View PR diff
gh pr diff 456

# Read inline review comments on a PR
gh api repos/tw93/Pake/pulls/456/comments

# Merge a PR (only with explicit user request)
gh pr merge 456 --squash

# Create a PR
gh pr create --title "..." --body "..."

Release Operations

# List releases
gh release list

# View a specific release
gh release view V3.10.0

# Check CI runs for a tag
gh run list --workflow=release.yml
gh run list --workflow=npm-publish.yml

# Watch a running CI job
gh run watch

# View CI run logs
gh run view <run-id> --log

# Verify npm registry state after publish
npm view pake-cli version
npm view pake-cli@<version> dist.tarball

CI / Workflow Operations

# List recent workflow runs
gh run list

# Filter by workflow
gh run list --workflow=release.yml
gh run list --workflow=quality-and-test.yml

# Re-run failed jobs
gh run rerun <run-id> --failed-only

Safety Rules

ALWAYS draft the reply first and show it to the user for approval before calling any write operation (gh issue comment, gh pr comment, gh pr merge, gh issue close, gh release create, etc.). Approval of one draft does not extend to future comments.
NEVER merge, close, or modify without explicit user request.
ALWAYS query current state before taking action — never assume.
Before replying to an issue or PR, read the body to confirm the author's language; match their language in the reply. This applies to the author, not to arbitrary thread commenters.
Before replying that a fix is released, verify the public artifact first: npm view pake-cli version for CLI releases or gh release view <tag> for app releases.
Before closing an issue after release, confirm the target with gh issue view <id> --json number,title,state,author,url and include the concrete version or upgrade command in the comment.