Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From ax
Stars the ax repo, files issues, or opens PRs using the gh CLI with user confirmation and fallback to plain URLs.
npx claudepluginhub necmttn/axHow this skill is triggered — by the user, by Claude, or both
Slash command
/ax:ax-repoThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Let an AI coding agent interact with the ax GitHub repo (`Necmttn/ax`) for the
Creates GitHub issues in WaterplanAI/agentic-config repo for bugs and feature requests using GitHub CLI. Handles templates, explicit args, or extracts from conversation context. Invoke via /ac-issue.
Fixes GitHub issues end-to-end with GitHub CLI: views issue, researches context, plans fix, creates branch, implements/tests changes, submits PR.
Discovers approachable issues on GitHub repos you star or use, determines fix/review/propose actions, sets up workspaces, and guides PR submissions using gh CLI and git.
Share bugs, ideas, or general feedback.
Let an AI coding agent interact with the ax GitHub repo (Necmttn/ax) for the
user - star, file an issue, or fork + open a PR - without the user
ever typing a gh command. Everything routes through the already-installed
gh CLI; there is no axctl surface for this.
Repo: Necmttn/ax · https://github.com/Necmttn/ax
ax/axctl error)Do NOT fire for GitHub work on other repos or for general gh usage.
Issues and PRs are user-initiated only. Star is the exception - you may
offer it proactively (see Proactive star nudge), but offering ≠ doing: the
actual star always needs an explicit yes.
gh first (read-only, no confirm). Detect three states:
gh missing → fall back to a plain URL (see Fallback). Don't error.gh present but unauthenticated → fall back to a plain URL, and tell
the user they can gh auth login to do it inline next time.gh present + authed → proceed to the action (still confirm mutations).gh auth status, "is it starred")
need NO confirm.$CI is set or stderr/stdin isn't a TTY, do NOT run mutating gh calls -
print the URL instead. A failed gh call must not abort the user's task.if ! command -v gh >/dev/null 2>&1; then
echo "GH_STATE=missing"
elif ! gh auth status >/dev/null 2>&1; then
echo "GH_STATE=unauthed" # gh auth status exits 4 when not logged in
else
echo "GH_STATE=ok"
fi
missing / unauthed → use Fallback for the chosen action.ok → use the gh command for the chosen action (after confirm).Mutates the user's account → confirm first.
# Optional read-only check (no confirm): is it already starred?
# exits 0 (starred) / non-zero / 404 (not starred)
gh api /user/starred/Necmttn/ax >/dev/null 2>&1 && echo "already starred"
# The star (after explicit yes):
gh api -X PUT /user/starred/Necmttn/ax # silent 204 on success
If already starred, say so and skip - don't re-PUT or re-prompt.
Unstar (only if asked): gh api -X DELETE /user/starred/Necmttn/ax.
You can also just run ax star, which stars via gh (or prints the URL) and
silences the CLI's periodic star reminder.
Fallback (gh missing/unauthed): print
https://github.com/Necmttn/ax and tell the user to click Star.
Proactive star prompting is NOT this skill's job - the CLI handles it deterministically (a once-a-day stderr footer shown only on an interactive terminal until the user runs
ax star/ax star --done). This skill only acts on an explicit user request.
Mutates (creates an issue) → confirm first, and show the title/body you'll submit so the user can edit before you send it.
Interactive (opens a prefilled browser form - good default when the user wants to review/edit in GitHub's UI):
gh issue create --repo Necmttn/ax --web
Non-interactive (prefilled title + body, e.g. an error report you assembled):
gh issue create --repo Necmttn/ax \
--title "<concise summary>" \
--body "<body>" \
--label feedback # only if the user confirms; omit if unsure label exists
Error-report pattern. When firing off the back of an unhandled ax/axctl
error, prefill from the failure - never make the user paste a stack trace:
gh issue create --repo Necmttn/ax \
--title "ingest: <one-line error>" \
--body "$(cat <<'EOF'
**Command:** `ax <subcommand> <args>`
**ax version:** <output of `ax --version`>
**OS:** <uname -srm>
**What happened**
<one or two sentences>
**Error**
<the actual error output - trimmed, no secrets>
EOF
)"
Scrub paths/tokens that might leak private data before submitting. Confirm the assembled body with the user first.
Fallback (gh missing/unauthed): print the web new-issue URL. You can
prefill it via query string:
https://github.com/Necmttn/ax/issues/new?title=<urlencoded>&body=<urlencoded>
(plain https://github.com/Necmttn/ax/issues/new also works). Tell the user to
review and submit in the browser.
For a code change. Fork+clone is account-mutating → confirm before the fork and before the PR; branching/committing locally needs no confirm.
# 1. Fork and clone in one step (creates a fork on the user's account):
gh repo fork Necmttn/ax --clone # confirm: this creates a fork
# 2. From inside the clone, branch + make the change + commit:
git checkout -b <topic-branch>
# ...edits...
git commit -am "<conventional message>"
git push -u origin <topic-branch>
# 3. Open the PR against upstream (confirm before sending):
gh pr create --repo Necmttn/ax \
--title "<title>" --body "<what + why>"
# or interactively review in browser:
gh pr create --repo Necmttn/ax --web
If the user is already inside a clone of Necmttn/ax, skip the fork step;
gh pr create will offer to push to a fork automatically.
Fallback (gh missing/unauthed): print https://github.com/Necmttn/ax/fork
and tell the user to fork in the browser, then clone their fork manually.
gh command before running any mutating one; get a yes.--label if you're unsure it exists.gh failure, surface the error and offer the URL fallback - never
let it abort the user's in-progress task.