github

Automate GitHub issue, PR, CI, and API tasks via the gh CLI.

3.9k|203|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/Dimillian/Skills --skill github-dimillian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github
Source: https://github.com/Dimillian/Skills/tree/main/github
Command: npx skills add https://github.com/Dimillian/Skills --skill github-dimillian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interact with GitHub programmatically to manage issues, pull requests, CI runs, and repository data without switching context to the web UI.

Core Features & Use Cases

  • Issue and PR management via gh commands, including checks, creation, and status queries.
  • CI and workflow visibility: list runs, inspect individual runs, and fetch logs for failed steps.
  • API access and data retrieval: query repository data using gh api with JSON outputs for automation and reporting.
  • Use Case: Suppose you need to report weekly PR health across multiple repos; run a script that fetches PR counts, checks status, and labels results in a dashboard.

Quick Start

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

  • 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 its logs: gh run view <run-id> --repo owner/repo
  • View failed step logs: gh run view <run-id> --repo owner/repo --log-failed
  • Get PR details via API: gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
  • List issues with details: gh issue list --repo owner/repo --json number,title --jq '.[] | "(.number): (.title)"'

Frequently Asked Questions about github

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check CI status and view logs for a GitHub pull request from the command line?

Check CI status on a GitHub pull request by running the gh pr checks command with a PR number and repository context. You can view workflow run logs and inspect failed steps using gh run view with the --log-failed flag.

How do I fetch structured repository data from GitHub for automation and reporting?

Fetch structured repository data from GitHub using the gh api command with JSON output. Query endpoints like repos/owner/repo/pulls and apply jq filters to extract specific fields for automation scripts and dashboard reporting.

Do I need to be inside a git directory to run gh CLI commands for issue and PR management?

You do not need to be inside a git directory to run gh CLI commands for issue and PR management. You can specify the repository context explicitly using the --repo owner/repo flag or use URLs directly with your commands.

What is the best way to list recent CI workflow runs across multiple repositories?

List recent CI workflow runs across multiple repositories by executing the gh run list command with the --repo flag and --limit parameter. This provides a quick view of recent workflow statuses without switching to the web UI.

Can I list GitHub issues with specific details like number and title in a single command?

List GitHub issues with specific details like number and title by running the gh issue list command with the --json flag. Apply a jq filter to format the output and display the exact fields needed for your workflow.

Why use the gh CLI to manage GitHub PRs and CI runs instead of the web UI?

Using the gh CLI to manage GitHub PRs and CI runs allows you to programmatically assess status, fetch logs, and query data without switching context to the web UI. This enables developers to automate reporting and interact with repositories directly from the terminal.