skill-git:scan

You are running /skill-git:scan. Follow these steps exactly.

All output shown to the user must be in English.

Task Tracking

You MUST create a task for each item below and update each task's status as you progress (pending → in_progress → completed):

1. Resolve target skills — validate requested skills or use all registered skills
2. Pre-filter by description — group skills by domain similarity, skip unrelated pairs
3. Extract rules (Phase 1) — load from cache or dispatch subagents to extract rules per skill
4. Cluster and analyze pairs (Phase 2) — pool rules into topics, derive overlap metrics per pair
5. Save results and output report — persist to latest.json and display merge suggestions

---

Prelude

!bash "${CLAUDE_PLUGIN_ROOT}/scripts/sg-prelude.sh" $ARGUMENTS

Parse $ARGUMENTS for remaining flags (after the prelude has consumed -a <value>):

1. Scan for -f or --force. If present, set force = true; otherwise force = false.
2. Extract all remaining tokens (non-flag, non-flag-value) as requested_skills list.

If STATUS is not ok:

• Re-examine RAW_ARGUMENTS — check if the user expressed an agent name or intent that can be semantically resolved (e.g. a typo, a paraphrase, or an implicit default).
• If you can determine intent, note the resolution and proceed.
• If STATUS is not_initialized and INITIALIZED_AGENTS is non-empty, suggest /skill-git:init -a <agent>.
• If STATUS is error, display REASON as a plain-language error and stop.
• If intent cannot be resolved, display a clear error and stop.

Use AGENT, GLOBAL_BASE, and SKILLS_JSON from prelude output for all subsequent steps. The skills map referred to throughout this document is the parsed content of SKILLS_JSON.

Agent name in positional position: If $ARGUMENTS contains a known agent name (claude, gemini, codex, openclaw) as a standalone positional token not preceded by -a, silently treat it as -a <agent>: override AGENT, re-read GLOBAL_BASE and SKILLS_JSON from ~/.skill-git/config.json for that agent. Do not pass it to requested_skills.