caddy-explain

# Caddy Explain When Caddy surfaces a hint and you don't see why, run `/caddy-explain` to see the deterministic scoring. The scoring should never be a black box. ## When to use - A [CADDY] hint fired and you're surprised by the choice - A [CADDY] hint *didn't* fire when you expected it to - You want to verify why a particular skill won (or lost) for a recent prompt - Triggered by Caddy on prompts like: "/caddy-explain", "why did Caddy suggest", "explain that hint", "why no hint", "why this skill", "Caddy scoring", "Caddy why" ## How to execute ### Step 1 — Identify the prompt being explained If the principal provides the prompt explicitly, use it. Otherwise: - Use the immediately-preceding user prompt from the current session - If there's ambiguity ("the one before the last hint"), ask one focused question ### Step 2 — Walk the scoring deterministically For each skill in `.claude/skill-index.json`: 1. List its triggers 2. For each trigger, check whether it appears in the prompt: - Multi-word phrase match (case-insensitive substring) → 3 points - Single-word boundary match (`\bword\b` regex) → 1 point - No match → 0 points 3. Sum the per-skill score ### Step 3 — Show the result Output format: ``` 🔍 Caddy scoring for prompt: "{prompt text}" Threshold: 2 (skills below this score are silent) Max hints: 2 (top scorers above threshold are surfaced) SURFACED: /skill-a — score 5 — matched: "phrase match" (3pts), "keyword" (1pt), "another" (1pt) /skill...