gh-stars-classifier-skill: Instructions file for Claude Code

GitHub Stars Classifier — Agent Workflow

Canonical, portable workflow shared by every agentic CLI that reads repo-local instruction files (Codex CLI, opencode, Claude Code, Gemini CLI via @import).

Goal: Organize the user's GitHub Stars into semantic categories and sync them to GitHub Lists. Categories are proposed dynamically based on what the user has actually starred — not from a hardcoded keyword table.

When to invoke

The user says things like:

• "organize my GitHub stars"
• "classify my starred repos into GitHub Lists"
• "clean up my starred repositories"

Prerequisites (check first, fail fast)

gh --version                                   # gh CLI installed
gh auth status                                 # authenticated
gh api user --jq .login                        # prints username
gh auth status 2>&1 | grep -q "'user'" || echo "need 'user' scope"

If user scope is missing: gh auth refresh -h github.com -s user.

Root resolver (run once, before any phase)

Every phase calls scripts under scripts/. Resolve the repo root before the first bash command of the session:

: "${GH_STARS_CLASSIFIER_ROOT:=${CLAUDE_PLUGIN_ROOT:-$PWD}}"
: "${GH_STARS_CLASSIFIER_ROOT:?set GH_STARS_CLASSIFIER_ROOT to the gh-stars-classifier-skill clone path}"
test -d "${GH_STARS_CLASSIFIER_ROOT}/scripts" || {
  echo "scripts/ not found under ${GH_STARS_CLASSIFIER_ROOT}"; exit 1;
}

• Claude Code plugin: CLAUDE_PLUGIN_ROOT is auto-set, so the resolver picks it up with no extra work.
• Codex CLI / opencode / Gemini CLI: cd into the repo clone (so $PWD works), or export GH_STARS_CLASSIFIER_ROOT explicitly.

Every python3 invocation below uses "${GH_STARS_CLASSIFIER_ROOT}/scripts/...". Do not invent ad-hoc one-liners — the bundled scripts cover every step.

Workflow

Follow these phases in order. Pause for user confirmation at each [CONFIRM] checkpoint.

Phase 1 — Fetch stars

mkdir -p .gh-stars-workspace
python3 "${GH_STARS_CLASSIFIER_ROOT}/scripts/fetch_stars.py" "$(gh api user --jq .login)" \
  --out .gh-stars-workspace/stars.json \
  --reuse-if-fresh 24