skills/wordpress/agent-skills/wp-project-triage

wp-project-triage

Installation
Summary

Deterministic WordPress repository inspection with structured JSON output for workflow guidance.

  • Detects project kind (plugin, theme, block theme, WP core, Gutenberg, full site) and outputs a schema-validated JSON report including tooling, tests, and version hints
  • Runs via Node.js detector script at repo root; outputs project.kind, signals, and tooling fields to guide downstream workflows
  • Identifies PHP/Node tooling presence and test frameworks to inform which commands and conventions apply before making changes
  • Targets WordPress 6.9+ with PHP 7.2.24+; re-run after structural changes like adding theme.json or block.json
SKILL.md

WP Project Triage

When to use

Use this skill to quickly understand what kind of WordPress repo you’re in and what commands/conventions to follow before making changes.

Inputs required

  • Repo root (current working directory).

Procedure

  1. Run the detector (prints JSON to stdout):
    • node skills/wp-project-triage/scripts/detect_wp_project.mjs
  2. If you need the exact output contract, read:
    • skills/wp-project-triage/references/triage.schema.json
  3. Use the report to select workflow guardrails:
    • project kind(s)
    • PHP/Node tooling present
    • tests present
    • version hints and sources
  4. If the report is missing signals you need, update the detector rather than guessing.

Verification

  • The JSON should parse and include: project.kind, signals, and tooling.
  • Re-run after changes that affect structure/tooling (adding theme.json, block.json, build config).

Failure modes / debugging

  • If it reports unknown, check whether the repo root is correct.
  • If scanning is slow, add/extend ignore directories in the script.
Weekly Installs
689
GitHub Stars
1.1K
First Seen
Feb 1, 2026
Installed on
claude-code458
codex452
cursor438
opencode426
gemini-cli422
github-copilot419