github

What This Skill Does

The GitHub skill enables your OpenClaw agent to interact directly with GitHub repositories via the robust gh CLI. By bridging the gap between natural language requests and command-line execution, the agent can perform complex repository management tasks without requiring you to switch contexts or manually use a browser. It supports full repository interaction including issue management, pull request monitoring, workflow investigation, and raw API access for granular data retrieval. Whether you need to triage bugs, check build statuses, or query specific metadata about your codebase, this skill provides a seamless, programmatic interface to your development environment.

Installation

To integrate this skill into your environment, use the OpenClaw installation command:

clawhub install openclaw/skills/skills/steipete/github

Ensure that the gh CLI is authenticated and configured correctly on the host machine before use, as the agent relies on the existing local credentials to access private repositories.

Use Cases

• Continuous Integration Monitoring: Automatically investigate failed CI runs to identify specific failing jobs without navigating the GitHub web UI.
• PR Triage and Management: Quickly list open pull requests, verify build check statuses, and format metadata for team reports using the JSON filtering capabilities.
• Advanced Data Queries: Extract specific fields like PR authors, labels, or custom metadata using gh api for internal tracking or auditing purposes.
• Automated Reporting: Use shell output to feed data into other tools or agents, facilitating automated workflows for project management.

Example Prompts

1. "Check the status of PR 55 in the openclaw/skills repository and tell me if the tests passed."
2. "List the last 5 workflow runs for our main repository and show me the logs for any failed steps."
3. "Get the title and author of all open issues in our repo and format them as a bulleted list for my daily update."

Tips & Limitations

• Authentication: Always ensure your local gh CLI is logged in via gh auth login before invoking the skill.
• Repository Scoping: If you are not operating inside a git-initialized directory, the --repo owner/repo flag is mandatory for every command to prevent errors.
• Power User tip: Leverage the --jq filter flag combined with --json output to reduce token consumption when asking the agent to process large amounts of data; it is more efficient to perform the filtering via the CLI than to pass massive raw JSON objects to the LLM.
• Safety: Use caution when performing destructive operations, such as closing issues or deleting branches, as these actions cannot be easily undone via the CLI.