wp-project-triage

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...

npx skills add https://github.com/wordpress/agent-skills --skill wp-project-triage

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.

More skills from wordpress

blueprint
wordpress
Use when creating, editing, or reviewing WordPress Playground blueprint JSON files. Triggers on mentions of blueprints, playground configuration, or requests…
official
wordpress-router
wordpress
Classify WordPress codebases and route to the correct workflow for plugins, themes, blocks, and core checkouts. Runs automated project triage to identify repo type (plugin, theme, block theme, Gutenberg blocks, WP core) and available tooling Outputs classification results and decision tree routing to domain-specific skills based on user intent and project kind Requires repo root access and bash/Node filesystem operations; some workflows need WP-CLI Targets WordPress 6.9+ with PHP 7.2.24+;...
official
wp-abilities-api
wordpress
WordPress Abilities API registration, REST exposure, and client-side consumption for WordPress 6.9+. Register abilities and categories in PHP using wp_register_ability() and wp_register_ability_category() with stable IDs, labels, and metadata Expose abilities to clients via the /wp-json/wp-abilities/v1/ REST endpoints by setting meta.show_in_rest: true Consume abilities in JavaScript using the @wordpress/abilities package for client-side access and permission checks Requires WordPress 6.9+...
official
wp-abilities-audit
wordpress
Audit a WordPress plugin's REST surface and produce a standardized audit document proposing Abilities API registrations. Produces a markdown doc with a YAML…
official
wp-abilities-verify
wordpress
Verify a WordPress plugin's Abilities API registrations: enumerate abilities, check that callback behavior matches each annotation's claim (the adversarial…
official
wp-block-development
wordpress
WordPress block development for Gutenberg: metadata, registration, rendering, and build workflows. Covers block creation, block.json configuration, static vs. dynamic rendering, and server-side PHP registration with register_block_type_from_metadata() Enforces apiVersion: 3 for WordPress 6.9+ compatibility, including iframe editor support and style isolation Handles attribute serialization, deprecations/migrations to prevent "Invalid block" errors, and inner blocks composition Includes...
official
wp-block-themes
wordpress
WordPress block theme development: theme.json, templates, patterns, and Site Editor troubleshooting. Covers theme.json editing (presets, settings, per-block styles), templates and template parts, patterns, and style variations across WordPress 6.9+ Includes triage scripts to detect theme roots and block theme structure, plus guided procedures for creating new themes or converting classic themes Provides debugging workflows for style hierarchy issues, user customization overrides, and Site...
official
wp-interactivity-api
wordpress
Use when building or debugging WordPress Interactivity API features (data-wp-* directives, @wordpress/interactivity store/state/actions, block viewScriptModule…
official