github

Overview

This skill enables an AI agent to interact with GitHub repositories directly using the official gh CLI. It provides a streamlined, command-driven interface for managing pull requests, inspecting CI workflow runs, and performing advanced queries via the GitHub API—all without leaving the chat environment.

Key Features

• Pull Request Management: Check CI status on any PR with gh pr checks and view logs for failed steps.
• Workflow Run Inspection: List recent CI runs, view details, and quickly access logs to debug failures.
• Advanced API Queries: Use gh api with --jq filtering to extract precise data from GitHub’s REST API.
• Structured Output: All commands support --json flag for machine-parseable results and --jq for custom formatting.
• Repository-Agnostic: Works with any public or private repo by specifying --repo owner/repo.

How It Works
The agent simply constructs and executes gh commands (e.g., gh pr checks 55 --repo owner/repo). The gh CLI must be installed and authenticated with a GitHub token. No additional plugins or complex setup are required—just authentication.

Use Cases

• Developer Triage: Quickly check if a PR’s CI tests are passing before review.
• CI Debugging: Inspect a failed workflow run and retrieve only the failed step’s logs.
• Data Extraction: Pull custom fields (e.g., PR titles, issue labels) from repositories using gh api and --jq.