mcpField
G
github

github

github.com/sickn33Development48.8k80 installsUpdated today
Repository

About github

A skill that guides use of the `gh` CLI for GitHub issues, pull requests, workflow runs, and API queries. It is intended for tasks involving repository activity and CI troubleshooting.

Key features

  1. 01Inspect pull request checks
  2. 02List and inspect workflow runs
  3. 03Retrieve failed-step logs
  4. 04Query GitHub API data
  5. 05Filter structured JSON output

Use cases

  1. 01Investigate a failing CI run
  2. 02Review pull request check status
  3. 03Find issues or pull requests
  4. 04Query repository fields with `gh api`

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill github

After installing, type/githubin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

GitHub Skill

Use the gh CLI to interact with GitHub. Always specify --repo owner/repo when not in a git directory, or use URLs directly.

When to Use

  • When the user asks about GitHub issues, pull requests, workflow runs, or CI failures.
  • When you need gh issue, gh pr, gh run, or gh api from the command line.

Pull Requests

Check CI status on a PR:

gh pr checks 55 --repo owner/repo

List recent workflow runs:

gh run list --repo owner/repo --limit 10

View a run and see which steps failed:

gh run view <run-id> --repo owner/repo

View logs for failed steps only:

gh run view <run-id> --repo owner/repo --log-failed
Debugging a CI Failure

Follow this sequence to investigate a failing CI run:

  1. Check PR status — identify which checks are failing: 
    gh pr checks 55 --repo owner/repo
  2. List recent runs — find the relevant run ID: 
    gh run list --repo owner/repo --limit 10
  3. View the failed run — see which jobs and steps failed: 
    gh run view <run-id> --repo owner/repo
  4. Fetch failure logs — get the detailed output for failed steps: 
    gh run view <run-id> --repo owner/repo --log-failed

API for Advanced Queries

The gh api command is useful for accessing data not available through other subcommands.

Get PR with specific fields:

gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

JSON Output

Most commands support --json for structured output. You can use --jq to filter:

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Comments

Markdown supported