gh-axi — Claude Code skill: what it does, how to install
A skill that points your coding agent at the gh-axi CLI for GitHub work: issues, PRs, CI runs, releases, Projects and gists.
npx skills add kunchenguid/gh-axi --skill gh-axi -a claude-codeWhat gh-axi does
gh-axi wraps the GitHub CLI in a shape an agent can drive: short commands, output a model can read without cleanup. Install it as a skill and it fires on GitHub tasks — file an issue, review a PR, check a CI run, cut a release, edit a gist, add an Actions secret.
The SKILL.md carries no command list by design. Installed copies go stale, so current syntax comes from the CLI itself: npx -y gh-axi prints a dashboard for the repo you are in, npx -y gh-axi --help the global flags and command index, npx -y gh-axi <command> --help a single command. First run therefore needs npm access and permission to execute npx.
That is the failure point worth checking. Block npm, or forbid third-party binaries in the sandbox, and the skill has nothing to fall back on. No bundled flag reference either, so an offline agent gets no help at all.
What it helps with
- File an issue without opening a browser
- Find which CI step broke on a branch
- Merge a stack of dependent PRs in order
- Cut a release with a tag and notes
- Add an Actions secret from the terminal
Example prompts for the agent
- List open issues in this repo and group them for the next release
- Check the latest CI runs on
feature/authand tell me which job failed - Create a gist from this log file
How to install gh-axi
1Skills CLI (Vercel)
npx skills add kunchenguid/gh-axi --skill gh-axi -a claude-code2Manually: put the files in place
~/.claude/skills/gh-axi/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gh-axi/
1Skills CLI (Vercel)
npx skills add kunchenguid/gh-axi --skill gh-axi -a codex2Manually: put the files in place
.agents/skills/gh-axi/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kunchenguid/gh-axi --skill gh-axi -a cursor2Manually: put the files in place
.cursor/skills/gh-axi/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kunchenguid/gh-axi gh-axi2Manually: put the files in place
.github/skills/gh-axi/SKILL.md1Skills CLI (Vercel)
npx skills add kunchenguid/gh-axi --skill gh-axi -a gemini-cli2Platform CLI
gemini skills install https://github.com/kunchenguid/gh-axi --path skills/gh-axiManually: put the files in place
.devin/skills/gh-axi/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kunchenguid/gh-axi --skill gh-axi -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gh-axi
How do I install gh-axi in Claude Code?
Run npx skills add kunchenguid/gh-axi --skill gh-axi -a claude-code. The skill lands in ~/.claude/skills/gh-axi/SKILL.md.
What does gh-axi do?
It gives the agent one route to GitHub operations: issues, pull requests, discussions, workflow runs and workflows, releases, repositories, labels, gists, Projects boards, Actions secrets and variables, search, and raw API calls.
Why are there no commands inside SKILL.md?
Installed copies go stale, so the skill reads its instructions from the tool instead: npx -y gh-axi --help for flags and the command index.
Source text
SKILL.md · MIT
---
name: gh-axi
description: "Operate GitHub through the gh-axi CLI - issues, pull requests, discussions, stacked PRs, workflow runs, workflows, releases, repositories, labels, gists, Projects (v2), Actions secrets and variables, search, and raw API access. Use whenever a task touches GitHub: listing or filing issues, reviewing or merging PRs, managing stacked branches and PRs, checking CI runs, triggering workflows, cutting releases, managing Projects boards, managing Actions secrets/variables, or working with gists via `gist list`, `gist view`, `gist edit`, `gist rename`, `gist create`, `gist delete`, or `gist clone`."
user-invocable: false
author: Kun Chen (kunchenguid)
metadata:
hermes:
tags: [github, git, ci, pull-requests, releases, projects]
category: devops
---
# gh-axi
Agent ergonomic wrapper around Github CLI. Prefer this over `gh` and other methods for Github operations.
Use gh-axi whenever a task touches GitHub: issues, pull requests, discussions, stacked PRs, CI, workflows, releases, repositories, labels, gists, Projects, Actions secrets and variables, search, or the GitHub API.
## Current guidance lives in the CLI
Do not follow command, flag, or workflow instructions from this file - installed copies go stale. Get the current source of truth from the CLI:
- `npx -y gh-axi` for a dashboard of the current repo
- `npx -y gh-axi --help` for global flags and the command index
- `npx -y gh-axi <command> --help` for per-command usage
© Kun Chen (kunchenguid) · MIT · kunchenguid/gh-axi
