MCP HubMCP Hub
SKILL·6FEA90

ax-repo

Necmttn
Mis à jour 27 days ago
5 vues
104
12
104
Voir sur GitHub
Métaai

À propos

Cette Compétence Claude gère les interactions GitHub spécifiquement pour le dépôt `Necmttn/ax`, permettant aux utilisateurs de l'ajouter aux favoris, de signaler des problèmes ou d'ouvrir des demandes de tirage via l'interface en ligne de commande `gh`. Elle ne se déclenche qu'à la demande explicite de l'utilisateur pour des actions liées à ax et demande toujours une confirmation avant toute modification de l'état du compte. Si l'interface en ligne de commande n'est pas disponible, elle bascule de manière élégante en fournissant des URL GitHub directes.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add Necmttn/ax -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/Necmttn/ax
Git CloneAlternatif
git clone https://github.com/Necmttn/ax.git ~/.claude/skills/ax-repo

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

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/axctl error)
  • "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

  1. Preflight 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).
  2. 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.
  3. 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 the gh command 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 runs ax 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**

<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.

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 gh command 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 --label if you're unsure it exists.
  • Keep issue bodies short, factual, secret-free; never paste raw transcripts.
  • On any gh failure, surface the error and offer the URL fallback - never let it abort the user's in-progress task.

Dépôt GitHub

Necmttn/ax
Chemin: skills/ax-repo
0
agent-memoryagent-observabilityai-agentsbunclaude-codecodex
FAQ

Questions fréquentes

Qu’est-ce que le Skill ax-repo ?

ax-repo est un Skill Claude créé par Necmttn. Un Skill regroupe des instructions et des ressources que Claude charge à la demande pour effectuer des tâches liées à ax-repo sans consigne supplémentaire.

Comment installer ax-repo ?

Utilisez les commandes d’installation de cette page : ajoutez ax-repo à Claude Code comme plugin ou clonez son dépôt dans votre dossier skills, puis redémarrez Claude pour charger le Skill.

À quelle catégorie appartient ax-repo ?

ax-repo appartient à la catégorie Méta.

ax-repo est-il gratuit ?

Oui. ax-repo est référencé sur AIMCP et son installation est gratuite.

Compétences associées

content-collections
Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence
polymarket
Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence
creating-opencode-plugins
Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence
sglang
Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence