wp-project-triage_skill

Overview

This skill performs a deterministic inspection of a WordPress repository and emits a structured JSON report to guide safe workflows and automation. It detects project kind (plugin, theme, block theme, WP core, Gutenberg, full site), tooling, tests, and version hints so agents and developers can choose appropriate guardrails before making changes.

How this skill works

Run the detector from the repository root to produce a JSON report describing project.kind, discovered signals, and tooling. The detector scans common WordPress indicators (file names, manifests, build configs, test folders, PHP/Node files) and synthesizes version hints and runnable commands. If signals are missing, update the detector rather than guessing.

When to use it

• Before automated edits or PRs to determine correct workflows and constraints
• When onboarding to an unknown WordPress repo to quickly assess structure and tooling
• To decide whether to run PHP or Node tests and which commands to invoke
• When creating CI jobs that must adapt to plugin vs theme vs block theme layouts
• To capture version hints for compatibility checks and release automation

Best practices

• Run the detector from the project root to avoid false unknown results
• Re-run after adding or changing build config or manifest files (theme.json, package.json, etc.)
• Treat the JSON report as authoritative for automation decisions; extend the detector if you need new signals
• Add ignore rules in the script to speed scanning on large repos
• Verify that the output contains project.kind, signals, and tooling before trusting downstream actions

Example use cases

• A CI pipeline selects test steps dynamically based on detected tooling (PHPUnit vs Jest)
• An agent decides whether to modify theme.json or plugin PHP based on detected project kind
• Release tooling extracts version hints to build accurate changelogs and compatibility metadata
• A developer triages an unknown repo to determine whether Gutenberg or core patches are needed
• Automation prevents unsafe edits by enforcing guardrails derived from the report