wp-project-triage — Claude Code skill: what it does, how to install
The skill inspects a WordPress repo and prints JSON: project kind, tooling and tests found, version hints. Handy before you touch an unfamiliar plugin or theme.
npx skills add WordPress/agent-skills --skill wp-project-triage -a claude-codeWhat wp-project-triage does
Point it at a WordPress folder and it tells you what lives there: a plugin, a classic theme, a block theme, WP core, Gutenberg, or a whole site. The answer comes back as JSON with the project kind, the signals it found, and the tooling in place.
Mechanically it is one script. node skills/wp-project-triage/scripts/detect_wp_project.mjs writes the report to stdout, and skills/wp-project-triage/references/triage.schema.json documents the expected shape. The agent then reads that report to pick guardrails: which commands exist, whether tests are set up, which versions the code targets. When a signal is missing, the author's advice is to extend the detector instead of guessing.
It targets WordPress 7.0+ and PHP 7.4.0+; the agent needs bash and node, and some workflows call for WP-CLI. That is worth checking before the first run. Got unknown back? Confirm the repo root. Scan dragging? Add ignore directories to the script. Re-run it once theme.json, block.json or a build config shows up.
What it helps with
- tell a plugin apart from a block theme before editing
- see which tests and build scripts the repo already carries
- find the WordPress and PHP versions the code aims at
- hand a machine-readable report to agent guardrails
- re-check the structure after adding
theme.jsonor a build config
Example prompts for the agent
- Run
node skills/wp-project-triage/scripts/detect_wp_project.mjsand tell me what kind of project this folder is. - Look at the triage report first: which tests can I actually run here?
- The report says
unknown— check the repo root and run the detector again.
How to install wp-project-triage
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-project-triage -a claude-code2Manually: put the files in place
~/.claude/skills/wp-project-triage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wp-project-triage/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-project-triage -a codex2Manually: put the files in place
.agents/skills/wp-project-triage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-project-triage -a cursor2Manually: put the files in place
.cursor/skills/wp-project-triage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wp-project-triage2Manually: put the files in place
.github/skills/wp-project-triage/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-project-triage -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-project-triageManually: put the files in place
.devin/skills/wp-project-triage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-project-triage -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wp-project-triage
How do I install wp-project-triage in Claude Code?
Run npx skills add WordPress/agent-skills --skill wp-project-triage -a claude-code. The skill file lands at ~/.claude/skills/wp-project-triage/SKILL.md.
What does wp-project-triage do?
It works out the kind of WordPress project and collects tooling, test and version signals into a structured JSON report. The agent uses that report to choose commands and checks.
What does it need to run?
WordPress 7.0+ and PHP 7.4.0+ in the project, plus bash and node on the agent side. Some workflows also require WP-CLI, so check for it up front.
