ax-repo Skill
通过调用 `gh` CLI,代替用户给 ax 仓库点星、提交 issue 或 bug 报告,或 fork github.com/Necmttn/ax 并发起 PR。当用户说“star ax”、“star the repo”、“我想支持 ax”、“把这个作为 ax 的 bug 报告”、“提交一个 ax issue”、“在 ax 上开个 issue”、“这看起来像 ax 的 bug”、“我想给 ax 做贡献”、“在 ax 里修复这个”、“给 ax 提个 PR”时触发,或者在 ax 出现未处理错误后用户想上报时触发。仅在用户明确请求时才执行——主动的 star 提示由 CLI(`ax star`)以确定性方式处理,而不是这个技能。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
ax:repo
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
When to fire
- "star ax" / "star the repo" / "I want to support ax" / "give ax a star"
- "report this as an ax bug" / "file an ax issue" / "open an issue on ax"
- "this looks like an ax bug" (after an
ax/axctlerror) - "I want to contribute to ax" / "fix this in ax" / "open a PR against ax"
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.
Non-negotiable rules
- Preflight
ghfirst (read-only, no confirm). Detect three states:
ghmissing → fall back to a plain URL (see Fallback). Don't error.ghpresent but unauthenticated → fall back to a plain URL, and tell
the user they can gh auth login to do it inline next time.
ghpresent + authed → proceed to the action (still confirm mutations).
- Confirm before any account-mutating call - star, issue create, PR
create all change the user's GitHub account/repo. Show the exact command,
get an explicit yes. Read-only checks (gh auth status, "is it starred")
need NO confirm.
- Never break the caller's exit code, never run silently in CI. If
$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.
Preflight (run this before every action)
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 theghcommand for the chosen action (after confirm).
Actions
1. Star
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 runsax star/ax star --done). This skill only
acts on an explicit user request.
2. File an issue / bug report
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**
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=&body=
(plain https://github.com/Necmttn/ax/issues/new also works). Tell the user to
review and submit in the browser.
3. Fork + open a PR (contribute)
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.
House rules
- Show the exact
ghcommand before running any mutating one; get a yes. - One action per request - don't star and file an issue unless asked for both.
- Don't invent labels/milestones; omit
--labelif you're unsure it exists. - Keep issue bodies short, factual, secret-free; never paste raw transcripts.
- On any
ghfailure, surface the error and offer the URL fallback - never
let it abort the user's in-progress task.