wp-project-triage

Detect WordPress repository characteristics and output a structured JSON report.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/MrGKanev/agent-skills --skill wp-project-triage-mrgkanev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-project-triage
Source: https://github.com/MrGKanev/agent-skills/tree/main/skills/wp-project-triage
Command: npx skills add https://github.com/MrGKanev/agent-skills --skill wp-project-triage-mrgkanev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Use this skill to quickly identify the structure and characteristics of a WordPress repository (plugin/theme/block/theme/WP core/Gutenberg) and produce a structured JSON report that guides workflows and safety guardrails.

Core Features & Use Cases

  • Detects project kind (plugin, theme, Gutenberg, WP core) and ownership signals (headers, WP-CLI usage, dependencies).
  • Outputs a JSON report detailing project kind, tooling presence, signals, and recommended actions for development and deployment.
  • Use Case: Run this in a WP repo to determine what tooling to enable (lint/test/run) and which guardrails to apply before making changes.

Quick Start

Run the detector to produce a JSON report:

  • node skills/wp-project-triage/scripts/detect_wp_project.mjs
  • For the exact report schema, consult references/triage.schema.json

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 a WordPress repository structure and detect its project type?

You can identify a WordPress repository structure by running a detection script that analyzes headers, WP-CLI usage, and dependencies to determine if the project is a plugin, theme, or WP core variant. It outputs a structured JSON report detailing these characteristics.

What is WordPress repo triage and when do I need it?

WordPress repo triage is the process of scanning a repository to surface tooling, signals, and recommended guardrails for development workflows. You need it before making changes to a WP plugin, theme, or core project to determine which safety actions to apply.

Can I generate a JSON report of WordPress project tooling and signals?

Yes, you can generate a JSON report of WordPress project tooling and signals by running the detection script. The script detects common WP assets, headers, and dependencies, producing a consistent JSON report conforming to a specific schema.

Does the WordPress project triage tool work with Gutenberg blocks and WP core?

Yes, the WordPress project triage tool works with Gutenberg blocks and WP core. It is designed to apply to WordPress repositories across plugins, themes, Gutenberg, WP core, and site variants to surface tooling and ownership signals.

What's the best way to determine guardrails and tooling for a WordPress development workflow?

The best way to determine guardrails and tooling for a WordPress development workflow is to run a deterministic detector script. It analyzes repository characteristics and outputs a JSON report guiding which lint, test, and run actions to enable before deployment.

Do I need Node.js to run the WordPress project detection script?

Yes, you need Node.js to run the WordPress project detection script. The quick start process involves executing a JavaScript module via Node to analyze the repository and generate the structured JSON report.