wp-project-triage

Detect WordPress repository kind and generate a structured triage report.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/javiercasares/cloudfest-wporgdownload --skill wp-project-triage-javiercasares
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-project-triage
Source: https://github.com/javiercasares/cloudfest-wporgdownload/tree/main/.claude/skills/wp-project-triage
Command: npx skills add https://github.com/javiercasares/cloudfest-wporgdownload --skill wp-project-triage-javiercasares

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill quickly identifies what kind of WordPress repository you are inspecting (plugin, theme, Gutenberg, WP core) and surfaces a structured triage report that guides workflow decisions.

Core Features & Use Cases

  • Detects repo kind, primary type, and available signals (headers, wp-content layout, tooling presence) and outputs a machine-readable report.
  • Useful before making changes to WordPress projects, WP plugins/themes, or Gutenberg workspaces to inform guardrails and next steps.
  • Provides a standard schema reference (references/triage.schema.json) to validate report structure and fields.

Quick Start

Use the wp-project-triage skill by running the detector on the repository root: node skills/wp-project-triage/scripts/detect_wp_project.mjs

Frequently Asked Questions about wp-project-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify what kind of WordPress repository I am working with?

Identify a WordPress repository by running a detection script on the root directory to inspect headers, wp-content layout, and tooling presence, which outputs a structured JSON triage report classifying the project as a plugin, theme, Gutenberg, or WP core.

Can I detect Gutenberg workspaces and monorepos using WordPress project triage?

Yes, WordPress project triage detects Gutenberg workspaces and monorepos by scanning for WordPress code, headers, and wp-content layouts, generating a structured report that surfaces detected kinds and available signals for any local repository.

What is the best way to generate a machine-readable triage report for a WP plugin or theme?

Generate a machine-readable triage report for a WP plugin or theme by running a Node.js detection script that validates output against a JSON schema, highlighting tooling presence and detected project kinds for workflow decisions.

Does WordPress project triage require wp-cli to detect the project kind?

No, WordPress project triage does not require wp-cli; it is a standalone Node.js script that deterministically identifies repo kind by inspecting local files, WordPress headers, and directory structures to output a JSON document.

How do I validate the structured JSON output from a WordPress repository triage?

Validate the structured JSON output from a WordPress repository triage by checking it against the references/triage.schema.json schema, which defines the required fields for signals, tooling, and detected project kinds.

Why do I need to triage a WordPress repository before making code changes?

Triaging a WordPress repository before making code changes informs guardrails and next steps by surfacing the primary project type and available tooling signals, ensuring workflow decisions match the detected kind of plugin, theme, or core.