refactor: move example/ into skills/<name>/examples/ for self-contained installs (#19)

Each skill now ships its sample input files and reference analysis outputs
inside its own directory, so installs via `cp -r skills/* ~/.claude/skills/`
include the examples without requiring the full repo clone.

All references in CLAUDE.md, README.md, HOW_TO_USE.md, SKILL.md files,
evals/evals.json, analysis .md files, and scripts/verify-docs.sh updated
to reflect the new paths.

Author: vanterx

CLAUDE.md

@@ -81,22 +81,22 @@ Provides sixteen slash-command skills — fifteen specialised review skills plus
 
 | Path | What it demonstrates |
 |------|---------------------|
-| [example/sqlplan-review/horrible.sqlplan](example/sqlplan-review/horrible.sqlplan) | Reference bad plan: parameter sniffing, spills, implicit conversion, key lookups |
-| [example/sqlplan-review/horrible-analysis.md](example/sqlplan-review/horrible-analysis.md) | Reference output of `/sqlplan-review` on the above plan |
-| [example/tsql-review/](example/tsql-review/) | `slow_proc.sql` with 12 anti-patterns + expected analysis |
-| [example/sqlstats-review/](example/sqlstats-review/) | SSMS STATISTICS IO/TIME output + expected analysis |
-| [example/sqlplan-compare/](example/sqlplan-compare/) | Baseline + regression `.sqlplan` pair + diff analysis |
-| [example/sqlplan-deadlock/](example/sqlplan-deadlock/) | P1 lock-order deadlock XML + analysis |
-| [example/sqltrace-review/](example/sqltrace-review/) | `fn_trace_gettable` output with N+1, sniffing, spills + analysis |
-| [example/sqlwait-review/](example/sqlwait-review/) | `sys.dm_os_wait_stats` output with I/O, lock, memory, CXPACKET + analysis |
-| [example/sqlplan-index-advisor/](example/sqlplan-index-advisor/) | Index advisor output for `horrible.sqlplan` |
-| [example/sqlplan-batch/](example/sqlplan-batch/) | Aggregate dashboard for a 3-plan batch |
-| [example/query-store-review/](example/query-store-review/) | Query Store DMV output with plan instability, forced plan failure, N+1 + analysis |
-| [example/procstats-review/](example/procstats-review/) | Q1 report output with CPU hotspot, parameter sniffing, N+1 caller, blocking signal + analysis |
-| [example/clusterlog-review/](example/clusterlog-review/) | CLUSTER.LOG with lease timeout, heartbeat loss, AG offline transition, VerboseLogging=0 + analysis |
-| [example/hadr-health-review/](example/hadr-health-review/) | 3-replica AG with disconnected secondary, 620 MB redo queue, secondary lag 85 sec + analysis |
-| [example/errorlog-review/](example/errorlog-review/) | ERRORLOG with I/O slow → AG lease expiry → failover sequence, login failure burst, trace flags + analysis |
-| [example/spn-review/](example/spn-review/) | setspn + AD attribute output: duplicate SPN, unconstrained delegation, missing delegation target SPN, end-user in Protected Users + analysis |
+| [skills/sqlplan-review/examples/horrible.sqlplan](skills/sqlplan-review/examples/horrible.sqlplan) | Reference bad plan: parameter sniffing, spills, implicit conversion, key lookups |
+| [skills/sqlplan-review/examples/horrible-analysis.md](skills/sqlplan-review/examples/horrible-analysis.md) | Reference output of `/sqlplan-review` on the above plan |
+| [skills/tsql-review/examples/](skills/tsql-review/examples/) | `slow_proc.sql` with 12 anti-patterns + expected analysis |
+| [skills/sqlstats-review/examples/](skills/sqlstats-review/examples/) | SSMS STATISTICS IO/TIME output + expected analysis |
+| [skills/sqlplan-compare/examples/](skills/sqlplan-compare/examples/) | Baseline + regression `.sqlplan` pair + diff analysis |
+| [skills/sqlplan-deadlock/examples/](skills/sqlplan-deadlock/examples/) | P1 lock-order deadlock XML + analysis |
+| [skills/sqltrace-review/examples/](skills/sqltrace-review/examples/) | `fn_trace_gettable` output with N+1, sniffing, spills + analysis |
+| [skills/sqlwait-review/examples/](skills/sqlwait-review/examples/) | `sys.dm_os_wait_stats` output with I/O, lock, memory, CXPACKET + analysis |
+| [skills/sqlplan-index-advisor/examples/](skills/sqlplan-index-advisor/examples/) | Index advisor output for `horrible.sqlplan` |
+| [skills/sqlplan-batch/examples/](skills/sqlplan-batch/examples/) | Aggregate dashboard for a 3-plan batch |
+| [skills/query-store-review/examples/](skills/query-store-review/examples/) | Query Store DMV output with plan instability, forced plan failure, N+1 + analysis |
+| [skills/procstats-review/examples/](skills/procstats-review/examples/) | Q1 report output with CPU hotspot, parameter sniffing, N+1 caller, blocking signal + analysis |
+| [skills/clusterlog-review/examples/](skills/clusterlog-review/examples/) | CLUSTER.LOG with lease timeout, heartbeat loss, AG offline transition, VerboseLogging=0 + analysis |
+| [skills/hadr-health-review/examples/](skills/hadr-health-review/examples/) | 3-replica AG with disconnected secondary, 620 MB redo queue, secondary lag 85 sec + analysis |
+| [skills/errorlog-review/examples/](skills/errorlog-review/examples/) | ERRORLOG with I/O slow → AG lease expiry → failover sequence, login failure burst, trace flags + analysis |
+| [skills/spn-review/examples/](skills/spn-review/examples/) | setspn + AD attribute output: duplicate SPN, unconstrained delegation, missing delegation target SPN, end-user in Protected Users + analysis |
 
 ## Installing Skills
 
@@ -138,7 +138,7 @@ These steps apply to any skill. Replace `<skill>` with the skill directory name
 5. Add a full `## <skill-name>` section to [README.md](README.md) with triggers, usage, and output sample
 6. Add the skill to [PERFORMANCE_TUNING_GUIDE.md](PERFORMANCE_TUNING_GUIDE.md) Skills at a Glance, Skill Scope Comparison, and relevant scenario sections
 7. Add the skill file size row to [LLM_COST_ESTIMATION.md](LLM_COST_ESTIMATION.md)
-8. Add example input + analysis files to `example/<skill-name>/`
+8. Add example input + analysis files to `skills/<skill-name>/examples/`
 9. Add `tsql-review` as companion in `sqlplan-review/SKILL.md` (or the relevant existing companion)
 
 ## Git Hooks

README.md

@@ -44,12 +44,12 @@ A collection of Claude Code skills covering the full SQL Server performance tuni
 **5 minutes to your first analysis:**
 
 1. Install the skills (see [Installation](#installation) below)
-2. In SSMS, open [example/sqlplan-review/horrible.sqlplan](example/sqlplan-review/horrible.sqlplan)
+2. In SSMS, open [skills/sqlplan-review/examples/horrible.sqlplan](skills/sqlplan-review/examples/horrible.sqlplan)
 3. In Claude Code, type:
    ```
-   /sqlplan-review example/sqlplan-review/horrible.sqlplan
+   /sqlplan-review skills/sqlplan-review/examples/horrible.sqlplan
    ```
-4. Compare the output to [example/sqlplan-review/horrible-analysis.md](example/sqlplan-review/horrible-analysis.md) — that's the reference gold-standard output showing the expected Critical / Warning / Info findings and Passed Checks table.
+4. Compare the output to [skills/sqlplan-review/examples/horrible-analysis.md](skills/sqlplan-review/examples/horrible-analysis.md) — that's the reference gold-standard output showing the expected Critical / Warning / Info findings and Passed Checks table.
 
 **Don't have a plan yet?** Use the symptom-based routing in [PERFORMANCE_TUNING_GUIDE.md](PERFORMANCE_TUNING_GUIDE.md) to pick the right skill for what you have.
 
@@ -1209,7 +1209,7 @@ R11–R15 (pattern detection), R16–R20 (trend analysis, requires ≥ 3 snapsho
 EXECUTE collect.usp_CollectProcStats;
 ```
 
-**Sample output:** See [`example/procstats-review/proc_stats_output-analysis.md`](example/procstats-review/proc_stats_output-analysis.md).
+**Sample output:** See [`skills/procstats-review/examples/proc_stats_output-analysis.md`](skills/procstats-review/examples/proc_stats_output-analysis.md).
 
 ---
 
@@ -1296,10 +1296,10 @@ symptom ──► /sql-triage ──► capture bundle ◄──┘ (if artifact
 
 **Sample outputs:**
 
-- [`example/mssql-performance-review/mixed-artifacts-analysis.md`](example/mssql-performance-review/mixed-artifacts-analysis.md) — artifact-driven review with full report
-- [`example/mssql-performance-review/symptom-first-analysis.md`](example/mssql-performance-review/symptom-first-analysis.md) — symptom-only triage with capture-bundle response
-- [`example/mssql-performance-review/capture-bundle-example/`](example/mssql-performance-review/capture-bundle-example/) — sample bundle (README, scripts, paste-back template, manifest.json)
-- [`example/mssql-performance-review/baseline-diff-analysis.md`](example/mssql-performance-review/baseline-diff-analysis.md) — verification report 24h after deploy with recommendation tags
+- [`skills/mssql-performance-review/examples/mixed-artifacts-analysis.md`](skills/mssql-performance-review/examples/mixed-artifacts-analysis.md) — artifact-driven review with full report
+- [`skills/mssql-performance-review/examples/symptom-first-analysis.md`](skills/mssql-performance-review/examples/symptom-first-analysis.md) — symptom-only triage with capture-bundle response
+- [`skills/mssql-performance-review/examples/capture-bundle-example/`](skills/mssql-performance-review/examples/capture-bundle-example/) — sample bundle (README, scripts, paste-back template, manifest.json)
+- [`skills/mssql-performance-review/examples/baseline-diff-analysis.md`](skills/mssql-performance-review/examples/baseline-diff-analysis.md) — verification report 24h after deploy with recommendation tags
 
 **When to use this vs a specialised skill directly:**
 
@@ -1346,7 +1346,7 @@ The orchestrator does not duplicate the specialised skills — it composes them.
 
 ## Example
 
-See [`example/sqlplan-review/horrible-analysis.md`](example/sqlplan-review/horrible-analysis.md) for a full analysis of [`example/sqlplan-review/horrible.sqlplan`](example/sqlplan-review/horrible.sqlplan) — a deliberately bad plan demonstrating parameter sniffing, memory grant failure, TempDb spills, leading-wildcard LIKE, implicit conversion, and 5M-row key lookups.
+See [`skills/sqlplan-review/examples/horrible-analysis.md`](skills/sqlplan-review/examples/horrible-analysis.md) for a full analysis of [`skills/sqlplan-review/examples/horrible.sqlplan`](skills/sqlplan-review/examples/horrible.sqlplan) — a deliberately bad plan demonstrating parameter sniffing, memory grant failure, TempDb spills, leading-wildcard LIKE, implicit conversion, and 5M-row key lookups.
 
 ---
 

mcp-server/src/skills-data.ts

@@ -105,19 +105,19 @@ else
 fi
 
 # ---------------------------------------------------------------------------
-# Check 6: Every skill has an example/ subfolder
+# Check 6: Every skill has an examples/ subfolder
 # ---------------------------------------------------------------------------
 echo ""
 echo "[ 6 ] Example folders"
 check6_ok=1
 for skill_dir in skills/*/; do
     name=$(basename "$skill_dir")
-    if [ ! -d "example/$name" ]; then
-        warn "example/$name/ is missing — add an input file and -analysis.md"
+    if [ ! -d "skills/$name/examples" ]; then
+        warn "skills/$name/examples/ is missing — add an input file and -analysis.md"
         check6_ok=0
     fi
 done
-[ "$check6_ok" -eq 1 ] && pass "All skills have example/ subfolders"
+[ "$check6_ok" -eq 1 ] && pass "All skills have examples/ subfolders"
 
 # ---------------------------------------------------------------------------
 # Check 7: Check prefix uniqueness — no letter used by two different skills
@@ -260,12 +260,13 @@ done
 [ "$check14_ok" -eq 1 ] && pass "Frontmatter description check counts match actual (for skills that declare them)"
 
 # ---------------------------------------------------------------------------
-# Check 15: Each example subfolder has at least one *-analysis.md
+# Check 15: Each skill's examples/ subfolder has at least one *-analysis.md
 # ---------------------------------------------------------------------------
 echo ""
 echo "[15 ] Example subfolders contain an analysis file"
 check15_ok=1
-for d in example/*/; do
+for skill_dir in skills/*/; do
+    d="${skill_dir}examples/"
     [ ! -d "$d" ] && continue
     analysis_count=$(ls "$d"*-analysis.md 2>/dev/null | wc -l | tr -d ' ')
     if [ "$analysis_count" -eq 0 ]; then

scripts/verify-docs.sh

@@ -192,7 +192,7 @@ These checks fire on SQL Server AG-specific resource events within the WSFC log
 ## Output Format
 
 Structure the report as follows. The reference output in
-`example/clusterlog-review/cluster-analysis.md` demonstrates the expected quality level.
+`skills/clusterlog-review/examples/cluster-analysis.md` demonstrates the expected quality level.
 
 ```
 ## Cluster Log Analysis

skills/clusterlog-review/SKILL.md

@@ -1,6 +1,6 @@
 # /clusterlog-review — Example Output
 
-Input: `example/clusterlog-review/cluster.log`
+Input: `skills/clusterlog-review/examples/cluster.log`
 
 ---