Run a deterministic inspection of any WordPress repo (plugin, theme, block theme, core, Gutenberg, or full site) to detect kind, tooling, tests, and version hints as structured JSON before making changes.
---
name: wp-project-triage
description: Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) - project kind, tooling/tests, version hints - emitted as a structured JSON report to guide workflows and guardrails before making changes. Targets WordPress 6.9+.
---
A fast, deterministic detector that tells you what kind of WordPress repo you're in before you change anything. It underpins the other WordPress agent skills.
## Workflow
1. Run the detector from the repo root: `node skills/wp-project-triage/scripts/detect_wp_project.mjs` (prints JSON to stdout).
2. Read `references/triage.schema.json` if you need the exact output contract.
3. Use the report to pick guardrails: project kind(s), PHP/Node tooling present, tests present, and version hints with their sources.
4. Confirm the JSON parses and includes `project.kind`, `signals`, and `tooling`; re-run after structural changes like adding `theme.json` or `block.json`.
5. If a needed signal is missing, extend the detector rather than guessing; if it reports `unknown`, verify the repo root is correct.
Full skill & source: https://github.com/WordPress/agent-skills/tree/aa735ea7111c7924ee988306bcef70439e17dec9/skills/wp-project-triage