# Github Agent Tools

> Use agent-tools GitHub wrappers for frequent GitHub operations before generating direct gh commands.

- Skill: `earayu/github-agent-tools` (Agent Skill)
- Install (CLI): `npx skillmds@latest add earayu/github-agent-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/earayu/github-agent-tools/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: earayu (https://skillmd.com/u/earayu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/earayu/github-agent-tools

---


# 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-limit` instead of direct `gh api rate_limit`.
- Use `just gh-ci-run <id>` instead of repeated `gh run view`.
- Use `just gh-ci-runs` instead of repeated workflow list polling.
- Use `just gh-pr <number>` before generating custom PR metadata queries.
- Use `just gh-file <path>` before `gh api repos/.../contents/...`.
- Use `--json` on `scripts/github/agent-gh.py` only 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 `--refresh` does not resolve it

When a direct command becomes common, add it to `agent-tools` instead of
copying it between agents.