earayu GitHub Agent Tools
Use this skill when an agent needs GitHub context for a project that has
agent-tools installed.
Rules
- Use
just gh-rate-limitinstead of directgh api rate_limit. - Use
just gh-ci-run <id>instead of repeatedgh run view. - Use
just gh-ci-runsinstead of repeated workflow list polling. - Use
just gh-pr <number>before generating custom PR metadata queries. - Use
just gh-file <path>beforegh api repos/.../contents/.... - Use
--jsononscripts/github/agent-gh.pyonly when the next tool needs structured data.
Escalation
Direct gh commands are still acceptable when:
- the wrapper does not cover the operation
- a write operation is required
- full logs are explicitly needed
- the wrapper returns stale data and
--refreshdoes not resolve it
When a direct command becomes common, add it to agent-tools instead of
copying it between agents.