fix: E2E validation — correct hook schema, enrich gateway keywords, add test script

rand · claude · rand · commit 2a3c9702516c · 2026-02-02T18:47:41.000-07:00
- Inline SessionStart hook in plugin.json (correct schema per Claude Code spec)
- Remove separate hooks/ directory (plugins use inline hooks, not separate files)
- Enrich 27 gateway descriptions with domain-specific trigger keywords
- Fix remaining discover-collab → discover-collaboration refs
- Fix deprecated Go ioutil.ReadFile → os.ReadFile in tls-configuration
- Add tests/validate.sh — 16 automated checks, all passing

Validated end-to-end: SessionStart hook, 5 category loading chains,
skill-navigator agent, cross-references (0 broken), 8 skill content
spot-checks (6 scored 5/5).

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -42,5 +42,17 @@
   "skills": "./skills",
   "agents": "./agents",
   "commands": "./commands",
-  "hooks": "./hooks"
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'cc-polymath plugin root: ${CLAUDE_PLUGIN_ROOT}'"
+          }
+        ]
+      }
+    ]
+  }
 }
diff --git a/commands/skills.md b/commands/skills.md
@@ -232,7 +232,7 @@ SPECIALIZED:
   discover-modal (2)       - Modal functions, scheduling
   discover-engineering (4) - Code review, documentation, leadership
   discover-product (4)     - Product strategy, roadmaps
-  discover-collab (5)      - Collaboration, code review, pair programming
+  discover-collaboration (5)      - Collaboration, code review, pair programming
 
 AGENT SKILLS (Root):
   elegant-design          - UI/UX design, accessibility, design systems
@@ -300,8 +300,8 @@ Try:
 No project files detected in current directory.
 
 GENERAL-PURPOSE GATEWAYS:
-→ discover-collab - Collaboration, documentation, CodeTour walkthroughs
-  Load: Read <cc-polymath-root>/skills/discover-collab/SKILL.md
+→ discover-collaboration - Collaboration, documentation, CodeTour walkthroughs
+  Load: Read <cc-polymath-root>/skills/discover-collaboration/SKILL.md
 
 ROOT-LEVEL SKILLS:
 → beads-workflow.md - Multi-session task management
diff --git a/hooks/hooks.json b/hooks/hooks.json
diff --git a/skills/README.md b/skills/README.md
@@ -326,7 +326,7 @@ Read <cc-polymath-root>/skills/product/INDEX.md
 ---
 
 ### Collaboration (5 skills)
-**Gateway**: `discover-collab`
+**Gateway**: `discover-collaboration`
 **Keywords**: collaboration, code review, documentation, pair programming
 **Skills**: Code review, documentation, pair programming, team workflows
 
diff --git a/skills/cryptography/tls-configuration.md b/skills/cryptography/tls-configuration.md
@@ -328,7 +328,7 @@ package main
 import (
     "crypto/tls"
     "crypto/x509"
-    "io/ioutil"
+    "os"
     "net/http"
 )
 
@@ -340,7 +340,7 @@ func main() {
     }
 
     // Load CA cert
-    caCert, err := ioutil.ReadFile("ca.crt")
+    caCert, err := os.ReadFile("ca.crt")
     if err != nil {
         panic(err)
     }
diff --git a/skills/discover-build-systems/SKILL.md b/skills/discover-build-systems/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-build-systems
-description: Automatically discover build system skills when working with build systems. Activates for build-systems development tasks.
+description: Automatically discover build system skills when working with Make, CMake, Bazel, Gradle, Maven, Cargo, Meson, build automation, or compilation. Activates for build-systems development tasks.
 ---
 
 # Build Systems Skills Discovery
diff --git a/skills/discover-caching/SKILL.md b/skills/discover-caching/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-caching
-description: Automatically discover caching and performance skills when working with caching. Activates for caching development tasks.
+description: Automatically discover caching and performance skills when working with Redis, Memcached, CDN, cache invalidation, HTTP caching, distributed caching, or cache patterns. Activates for caching development tasks.
 ---
 
 # Caching Skills Discovery
diff --git a/skills/discover-cicd/SKILL.md b/skills/discover-cicd/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-cicd
-description: Automatically discover CI/CD and automation skills when working with CI/CD. Activates for cicd development tasks.
+description: Automatically discover CI/CD and automation skills when working with GitHub Actions, Jenkins, GitLab CI, pipelines, continuous integration, continuous deployment, or automated testing. Activates for CI/CD development tasks.
 ---
 
 # Cicd Skills Discovery
diff --git a/skills/discover-collaboration/SKILL.md b/skills/discover-collaboration/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-collaboration
-description: Automatically discover collaboration and teamwork skills when working with collaboration. Activates for collaboration development tasks.
+description: Automatically discover collaboration and teamwork skills when working with code review, pair programming, GitHub, pull requests, team workflows, or documentation. Activates for collaboration development tasks.
 ---
 
 # Collaboration Skills Discovery
diff --git a/skills/discover-containers/SKILL.md b/skills/discover-containers/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-containers
-description: Automatically discover container and Docker skills when working with Docker. Activates for containers development tasks.
+description: Automatically discover container skills when working with Docker, Dockerfile optimization, docker-compose, container networking, container security, container registries, or Kubernetes. Activates for containerization and orchestration tasks.
 ---
 
 # Containers Skills Discovery
diff --git a/skills/discover-data/SKILL.md b/skills/discover-data/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-data
-description: Automatically discover data pipeline and ETL skills when working with ETL. Activates for data development tasks.
+description: Automatically discover data pipeline and ETL skills when working with ETL, data pipelines, streaming, batch processing, data validation, or pipeline orchestration. Activates for data development tasks.
 ---
 
 # Data Skills Discovery
diff --git a/skills/discover-debugging/SKILL.md b/skills/discover-debugging/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-debugging
-description: Automatically discover debugging and profiling skills when working with debugging. Activates for debugging development tasks.
+description: Automatically discover debugging and profiling skills when working with GDB, LLDB, breakpoints, profiling, stack traces, memory leaks, core dumps, or performance profiling. Activates for debugging development tasks.
 ---
 
 # Debugging Skills Discovery
diff --git a/skills/discover-deployment/SKILL.md b/skills/discover-deployment/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-deployment
-description: Automatically discover deployment and release skills when working with deployment. Activates for deployment development tasks.
+description: Automatically discover deployment and release skills when working with Netlify, Heroku, blue-green, canary, rolling deployment, or platform deployment. Activates for deployment development tasks.
 ---
 
 # Deployment Skills Discovery
diff --git a/skills/discover-ebpf/SKILL.md b/skills/discover-ebpf/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-ebpf
-description: Automatically discover eBPF and kernel skills when working with eBPF. Activates for ebpf development tasks.
+description: Automatically discover eBPF and kernel skills when working with eBPF, kernel tracing, XDP, kprobes, BPF, Linux kernel, or network filtering. Activates for eBPF development tasks.
 ---
 
 # Ebpf Skills Discovery
diff --git a/skills/discover-engineering/SKILL.md b/skills/discover-engineering/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-engineering
-description: Automatically discover software engineering practice skills when working with engineering practices. Activates for engineering development tasks.
+description: Automatically discover software engineering practice skills when working with code review, documentation, pair programming, production debugging, performance profiling, deployment strategies, or software engineering practices. Activates for engineering development tasks.
 ---
 
 # Engineering Skills Discovery
diff --git a/skills/discover-formal/SKILL.md b/skills/discover-formal/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-formal
-description: Automatically discover formal methods and verification skills when working with formal methods. Activates for formal development tasks.
+description: Automatically discover formal methods and verification skills when working with formal verification, Z3, SAT, SMT, Lean, theorem proving, model checking, or constraint solving. Activates for formal methods development tasks.
 ---
 
 # Formal Skills Discovery
diff --git a/skills/discover-infrastructure/SKILL.md b/skills/discover-infrastructure/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-infrastructure
-description: Automatically discover infrastructure and DevOps skills when working with infrastructure. Activates for infrastructure development tasks.
+description: Automatically discover infrastructure and DevOps skills when working with Terraform, IaC, infrastructure as code, cloud platforms, Cloudflare Workers, or cost optimization. Activates for infrastructure development tasks.
 ---
 
 # Infrastructure Skills Discovery
diff --git a/skills/discover-ir/SKILL.md b/skills/discover-ir/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-ir
-description: Automatically discover intermediate representation and compiler skills when working with intermediate representation. Activates for ir development tasks.
+description: Automatically discover intermediate representation and compiler skills when working with LLVM IR, SSA, compiler optimization, intermediate representation, code generation, or optimization passes. Activates for IR development tasks.
 ---
 
 # Ir Skills Discovery
diff --git a/skills/discover-math/SKILL.md b/skills/discover-math/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-math
-description: Automatically discover mathematics and algorithm skills when working with mathematics. Activates for math development tasks.
+description: Automatically discover mathematics and algorithm skills when working with linear algebra, calculus, optimization, statistics, probability, numerical methods, category theory, or topology. Activates for math development tasks.
 ---
 
 # Math Skills Discovery
diff --git a/skills/discover-ml/SKILL.md b/skills/discover-ml/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-ml
-description: Automatically discover machine learning and AI skills when working with machine learning. Activates for ml development tasks.
+description: Automatically discover machine learning and AI skills when working with machine learning, PyTorch, training, inference, RAG, embeddings, fine-tuning, LLM, DSPy, HuggingFace, or diffusion models. Activates for ML development tasks.
 ---
 
 # Ml Skills Discovery
diff --git a/skills/discover-mobile/SKILL.md b/skills/discover-mobile/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-mobile
-description: Automatically discover mobile development skills when working with iOS. Activates for mobile development tasks.
+description: Automatically discover mobile development skills when working with iOS, Android, Swift, SwiftUI, React Native, mobile development, SwiftData, or app development. Activates for mobile development tasks.
 ---
 
 # Mobile Skills Discovery
diff --git a/skills/discover-modal/SKILL.md b/skills/discover-modal/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-modal
-description: Automatically discover Modal platform skills when working with Modal. Activates for modal development tasks.
+description: Automatically discover Modal platform skills when working with Modal, serverless GPU, cloud functions, Modal.com, GPU workloads, web endpoints, or scheduled jobs. Activates for Modal development tasks.
 ---
 
 # Modal Skills Discovery
diff --git a/skills/discover-networking/SKILL.md b/skills/discover-networking/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-networking
-description: Automatically discover networking and connectivity skills when working with networking. Activates for networking development tasks.
+description: Automatically discover networking and connectivity skills when working with TCP, UDP, DNS, mTLS, NAT traversal, SSH, Mosh, Tailscale, or network resilience. Activates for networking development tasks.
 ---
 
 # Networking Skills Discovery
diff --git a/skills/discover-observability/SKILL.md b/skills/discover-observability/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-observability
-description: Automatically discover observability and monitoring skills when working with monitoring. Activates for observability development tasks.
+description: Automatically discover observability and monitoring skills when working with Prometheus, Grafana, distributed tracing, structured logging, metrics, alerting, dashboards, or monitoring. Activates for observability development tasks.
 ---
 
 # Observability Skills Discovery
diff --git a/skills/discover-plt/SKILL.md b/skills/discover-plt/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-plt
-description: Automatically discover programming language theory skills when working with compilers. Activates for plt development tasks.
+description: Automatically discover programming language theory skills when working with compilers, parsers, type systems, interpreters, grammars, language design, type theory, or abstract syntax tree. Activates for PLT development tasks.
 ---
 
 # Plt Skills Discovery
diff --git a/skills/discover-product/SKILL.md b/skills/discover-product/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-product
-description: Automatically discover product management skills when working with product management. Activates for product development tasks.
+description: Automatically discover product management skills when working with product management, roadmap, user stories, prioritization, metrics, or product strategy. Activates for product development tasks.
 ---
 
 # Product Skills Discovery
diff --git a/skills/discover-realtime/SKILL.md b/skills/discover-realtime/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-realtime
-description: Automatically discover realtime communication skills when working with realtime. Activates for realtime development tasks.
+description: Automatically discover realtime communication skills when working with WebSocket, Server-Sent Events, SSE, pub/sub, real-time communication, or live updates. Activates for realtime development tasks.
 ---
 
 # Realtime Skills Discovery
diff --git a/skills/discover-research/SKILL.md b/skills/discover-research/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-research
-description: Gateway skill for research methodology - automatically loads relevant research skills based on task context
+description: Automatically discover research methodology skills when working with research methodology, literature review, systematic review, evidence synthesis, academic research, or experimental design. Activates for research tasks.
 ---
 
 # Research Skills Discovery
diff --git a/skills/discover-testing/SKILL.md b/skills/discover-testing/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-testing
-description: Automatically discover testing skills when working with testing. Activates for testing development tasks.
+description: Automatically discover testing skills when working with unit testing, integration testing, e2e testing, TDD, test coverage, mocking, pytest, Jest, or test automation. Activates for testing development tasks.
 ---
 
 # Testing Skills Discovery
diff --git a/skills/discover-tui/SKILL.md b/skills/discover-tui/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-tui
-description: Automatically discover terminal UI skills when working with terminal user interfaces. Activates for tui development tasks.
+description: Automatically discover terminal UI skills when working with terminal UI, Ratatui, Bubbletea, ncurses, TUI, terminal rendering, or command-line interface. Activates for TUI development tasks.
 ---
 
 # Tui Skills Discovery
diff --git a/skills/discover-wasm/SKILL.md b/skills/discover-wasm/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-wasm
-description: Automatically discover WebAssembly skills when working with WebAssembly. Activates for wasm development tasks.
+description: Automatically discover WebAssembly skills when working with WebAssembly, WASM, WASI, wasm-bindgen, Rust to WASM, wasm-pack, or browser runtime. Activates for WASM development tasks.
 ---
 
 # Wasm Skills Discovery
diff --git a/skills/discover-workflow/SKILL.md b/skills/discover-workflow/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-workflow
-description: Automatically discover workflow and task management skills when working with Beads. Activates for workflow development tasks.
+description: Automatically discover workflow and task management skills when working with task management, Beads, workflow automation, multi-session patterns, or project tracking. Activates for workflow development tasks.
 ---
 
 # Workflow Skills Discovery
diff --git a/skills/discover-zig/SKILL.md b/skills/discover-zig/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: discover-zig
-description: Automatically discover Zig programming skills when working with Zig. Activates for zig development tasks.
+description: Automatically discover Zig programming skills when working with Zig, comptime, allocators, build.zig, safety, C interop, memory management, or systems programming. Activates for Zig development tasks.
 ---
 
 # Zig Skills Discovery
diff --git a/tests/validate.sh b/tests/validate.sh

Original file line number	Diff line number	Diff line change
`@@ -328,7 +328,7 @@ package main`
`328`	`328`	`import (`
`329`	`329`	`"crypto/tls"`
`330`	`330`	`"crypto/x509"`
`331`		`- "io/ioutil"`
	`331`	`+ "os"`
`332`	`332`	`"net/http"`
`333`	`333`	`)`
`334`	`334`
`@@ -340,7 +340,7 @@ func main() {`
`340`	`340`	`}`
`341`	`341`
`342`	`342`	`// Load CA cert`
`343`		`- caCert, err := ioutil.ReadFile("ca.crt")`
	`343`	`+ caCert, err := os.ReadFile("ca.crt")`
`344`	`344`	`if err != nil {`
`345`	`345`	`panic(err)`
`346`	`346`	`}`