# Gh CLI

> Use for GitHub-related tasks such as managing issues, pull requests, actions runs, and repository configuration using the GitHub CLI (gh).

- Skill: `yamcodes/gh-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yamcodes/gh-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yamcodes/gh-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yamcodes (https://skillmd.com/u/yamcodes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yamcodes/gh-cli

---


# Gh CLI

This skill provides guidance for using the GitHub CLI (`gh`) to automate and streamline GitHub workflows.

## Common workflows

### Actions & runs

- **List recent runs**: `gh run list`
- **View a specific run**: `gh run view <run-id>`
- **View job logs**: `gh run view <run-id> --job <job-id> --log`
- **Rerun failed jobs**: `gh run rerun <run-id> --failed`

### Pull requests

- **List PRs**: `gh pr list`
- **View PR details**: `gh pr view <pr-number>`
- **Check PR status**: `gh pr status`
- **Create a PR**: `gh pr create --title "..." --body "..."`
- **Merge a PR**: `gh pr merge <pr-number> --merge` (or `--squash`, `--rebase`)

### Issues

- **List issues**: `gh issue list`
- **View issue**: `gh issue view <issue-number>`
- **Create issue**: `gh issue create --title "..." --body "..."`

## Best practices

- **Use `--repo`**: When working in a multi-repo context or if not in a git repo, always specify `--repo <owner>/<repo>`.
- **JSON Output**: Use `--json` with `-q` (jq filter) for scriptable output.
- **Help**: Use `gh <command> --help` to discover more flags.

See [references/commands.md](references/commands.md) for a comprehensive list of commands and examples.