How do I install the Github CLI skill?

Run npx skillmds@latest add grandamenium/github-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github CLI?

grandamenium (@grandamenium) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github CLI by grandamenium — Agent Skill

Name: Github CLI
Author: grandamenium

File contents

GitHub CLI (gh)

Official CLI for GitHub. Manage repos, PRs, issues, actions, gists, and releases without leaving the terminal.

Official repo: https://github.com/cli/cli
Docs: https://cli.github.com/manual/

Authentication

gh auth login            # Interactive login (browser or token)
gh auth status           # Check current auth
gh auth token            # Print current token

Common Commands

Repositories

gh repo create my-app --public --clone
gh repo clone owner/repo
gh repo view owner/repo --web
gh repo list owner --limit 20
gh repo fork owner/repo --clone

Pull Requests

gh pr create --title "Title" --body "Description"
gh pr list --state open
gh pr view 123
gh pr checkout 123
gh pr merge 123 --squash --delete-branch
gh pr review 123 --approve
gh pr diff 123
gh pr checks 123

Issues

gh issue create --title "Bug" --body "Details" --label bug
gh issue list --state open --assignee @me
gh issue view 456
gh issue close 456
gh issue comment 456 --body "Fixed in #123"

Actions / Workflows

gh run list --limit 10
gh run view 789
gh run watch 789
gh run rerun 789
gh workflow list
gh workflow run deploy.yml --ref main

Releases

gh release create v1.0.0 --title "v1.0.0" --notes "Release notes"
gh release list
gh release download v1.0.0

API (raw access)

gh api repos/owner/repo/pulls/123/comments
gh api graphql -f query='{ viewer { login } }'
gh api repos/owner/repo --jq '.stargazers_count'

Agent Best Practices

Always use --json flag with --jq for structured output: gh pr list --json number,title --jq '.[].title'
Use gh api for anything not covered by built-in commands
Pass PR/issue bodies via heredoc for multi-line content
Use --repo owner/repo flag when working outside the repo directory
Check gh auth status before operations to confirm authentication
Prefer gh pr create --body "$(cat <<'EOF' ... EOF)" for formatted bodies

Example Workflows

Create PR with full context

gh pr create --title "Add user auth" --body "$(cat <<'EOF'
## Summary
- Added JWT authentication middleware
- Created login/register endpoints

## Test Plan
- [x] Unit tests pass
- [ ] Manual testing needed
EOF
)"

Get CI status for current branch

gh pr checks --json name,state --jq '.[] | "\(.name): \(.state)"'

---name: github-clidescription: Use the GitHub CLI (gh) to manage repositories, pull requests, issues, actions, and releases directly from the terminal. Use this instead of the GitHub MCP server.---# GitHub CLI (gh)Official CLI for GitHub. Manage repos, PRs, issues, actions, gists, and releases without leaving the terminal.- **Official repo:** https://github.com/cli/cli- **Docs:** https://cli.github.com/manual/## Authentication```bashgh auth login # Interactive login (browser or token)gh auth status # Check current authgh auth token # Print current token```## Common Commands### Repositories```bashgh repo create my-app --public --clonegh repo clone owner/repogh repo view owner/repo --webgh repo list owner --limit 20gh repo fork owner/repo --clone```### Pull Requests```bashgh pr create --title "Title" --body "Description"gh pr list --state opengh pr view 123gh pr checkout 123gh pr merge 123 --squash --delete-branchgh pr review 123 --approvegh pr diff 123gh pr checks 123```### Issues```bashgh issue create --title "Bug" --body "Details" --label buggh issue list --state open --assignee @megh issue view 456gh issue close 456gh issue comment 456 --body "Fixed in #123"```### Actions / Workflows```bashgh run list --limit 10gh run view 789gh run watch 789gh run rerun 789gh workflow listgh workflow run deploy.yml --ref main```### Releases```bashgh release create v1.0.0 --title "v1.0.0" --notes "Release notes"gh release listgh release download v1.0.0```### API (raw access)```bashgh api repos/owner/repo/pulls/123/commentsgh api graphql -f query='{ viewer { login } }'gh api repos/owner/repo --jq '.stargazers_count'```## Agent Best Practices- Always use `--json` flag with `--jq` for structured output: `gh pr list --json number,title --jq '.[].title'`- Use `gh api` for anything not covered by built-in commands- Pass PR/issue bodies via heredoc for multi-line content- Use `--repo owner/repo` flag when working outside the repo directory- Check `gh auth status` before operations to confirm authentication- Prefer `gh pr create --body "$(cat <<'EOF' ... EOF)"` for formatted bodies## Example Workflows### Create PR with full context```bashgh pr create --title "Add user auth" --body "$(cat <<'EOF'## Summary- Added JWT authentication middleware- Created login/register endpoints## Test Plan- [x] Unit tests pass- [ ] Manual testing neededEOF)"```### Get CI status for current branch```bashgh pr checks --json name,state --jq '.[] | "\(.name): \(.state)"'```

Frequently asked questions

Github CLI