wp-project-triage

The wp-project-triage skill provides deterministic inspection and analysis of WordPress repositories, identifying project types (plugins, themes, block themes, WordPress core, Gutenberg, or full sites) and their technical characteristics. It generates structured JSON reports that capture tooling configurations, testing infrastructure, version information, and other critical signals needed to guide development workflows and establish guardrails before making changes.

This skill analyzes repository structure and metadata to detect PHP and Node.js tooling presence, identify test frameworks, parse version hints from multiple sources, and classify the WordPress project kind. The detection runs through a Node.js script that scans the filesystem and outputs a comprehensive JSON report conforming to a documented schema. The report includes project classification, available tooling (Composer, npm, WP-CLI), testing infrastructure (PHPUnit, Jest, Playwright), and version constraints from composer.json, package.json, and WordPress-specific files.

Target users include AI agents, automation tools, and developers working across diverse WordPress codebases who need reliable project context before executing commands or modifications. The skill helps prevent workflow errors by establishing what conventions and tools are available in each repository, whether it's a simple plugin, a modern block theme with build tooling, or WordPress core itself. By providing this structured analysis upfront, teams can build safer automation that respects project-specific requirements and tooling configurations.