skills/platform/observability/SKILL.md
Use when monitoring or diagnosing the wicked-garden plugin ecosystem — health probes, contract assertions, hook traces, error pattern detection, and APM/logging/metrics toolchain discovery. NOT for distributed tracing across services (use the platform:traces command) or audit evidence (use platform/audit).
npx skillsauth add mikeparcewski/wicked-garden observabilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Monitor and diagnose the wicked-garden plugin ecosystem — health probes, contract assertions, and hook execution traces.
# Check ecosystem health
/wicked-garden:platform:health
# Query recent hook traces
/wicked-garden:platform:traces --tail 20
# Validate script output contracts
/wicked-garden:platform:assert
| Command | Purpose |
|---------|---------|
| /wicked-garden:platform:health | Run health probes against plugins |
| /wicked-garden:platform:traces | Query hook execution traces for the session |
| /wicked-garden:platform:assert | Validate script outputs against declared schemas |
Validate ecosystem integrity by checking plugin structure, hook bindings, and script availability.
# All plugins
/wicked-garden:platform:health
# Single plugin, machine-readable
/wicked-garden:platform:health --plugin wicked-garden --json
Exit codes: 0 = healthy, 1 = warnings, 2 = failures.
Every hook execution is traced with timing, exit codes, and silent failure detection. Query traces to diagnose issues.
# Last 10 traces
/wicked-garden:platform:traces --tail 10
# Only silent failures (exit 0 but unexpected output)
/wicked-garden:platform:traces --silent-only
# Trace stats
/wicked-garden:platform:traces --stats
Validate that plugin scripts return data matching their declared JSON schemas.
# Run all assertions
/wicked-garden:platform:assert
# Single plugin
/wicked-garden:platform:assert --plugin wicked-garden
Schemas live in schemas/{plugin}/{script}.json.
/wicked-garden:platform:health — check structural integrity/wicked-garden:platform:traces --silent-only — find silent failures/wicked-garden:platform:assert — validate output contracts/wicked-garden:platform:traces --tail 20 — check if hook was invoked/wicked-garden:platform:assert --plugin {name} — check contract complianceDiscover and interact with monitoring CLIs available in the current environment.
# Discover what monitoring tools are installed
/wicked-garden:platform:toolchain
# Query logs with detected CLI
/wicked-garden:platform:toolchain --query "error last 1h"
# Detect by category
/wicked-garden:platform:toolchain --category apm
| Category | Tools Detected |
|----------|---------------|
| APM | datadog-agent, newrelic-cli, dt (Dynatrace) |
| Logging | splunk, elk / elasticsearch, kibana |
| Metrics | promtool (Prometheus), grafana-cli |
| Cloud | aws cloudwatch, gcloud monitoring, az monitor |
Detection uses command -v — no external dependencies.
→ See refs/toolchain-discovery.md for detection patterns and per-tool usage examples.
development
--- name: large-scale-migration description: How to execute a LARGE MECHANICAL change across any codebase with LEVERAGE instead of an agent-grind or hand-edits — a cross-cutting migration, refactor, rename, dialect/framework/DB port, library adoption, or bulk transform. The map→transform→gate pattern: a deterministic transform driven by a source-of-truth map, proven by a differential-equivalence gate. Use when the work is "migrate all X to Y", "rename Z everywhere", "port to a new DB/dialect/fra
testing
v11 LLM-based work-shape classifier. Replaces the regex archetype detector with the model's own reasoning. Reads the user's prompt, picks the right archetype(s) from the catalog, identifies signals (blast_radius, novelty, reversibility, etc.), and persists to SessionState so subsequent turns steer correctly. Use when: the prompt_submit hook emitted a `<wg classify-due />` directive, OR explicitly invoked at session start, OR when re-classifying after the user changes scope mid-session.
tools
v11 work-shape archetype runner. When a prompt has been routed to one of the 9 archetypes (triage, explore, specify, decide, ship, review, incident, build, migrate), this skill is the entry point. It picks the right per-archetype playbook from refs/ and executes the phase shape declared in `.claude-plugin/archetypes.json`. Use when: a `<wg archetype="X">` or `<wg archetypes>` system-reminder tag appears, an explicit "let's run the X archetype" request, or when one of the per-archetype slash commands resolves to this skill.
development
Show or set the session intent variable. Intent gates how loud the framework is — simple-edit (silent), feature/research (synthesis directive), rigor (full crew context). Auto-detected on turn 1; this skill overrides explicitly. Sticky for the session. Use when: "set intent", "intent override", "/wicked-garden:intent", "make the framework quiet", "force rigor", "what's my intent".