WordPress Theme Team Skills

This skill pack is optimized for WordPress theme teams (classic and block themes): clear architecture, explicit guardrails, and verification-first workflows.

Quick Install

Install all skills into the current project:

npx wp-skills install --dest=. --targets=codex,vscode,claude,cursor,antigravity

List available skills:

npx wp-skills list

Install a single skill:

npx wp-skills install --dest=. --targets=codex,vscode,claude,cursor,antigravity --skills=classic-theme-dev

Installed locations:

• .codex/skills/
• .github/skills/
• .claude/skills/
• .cursor/skills/
• .agent/skill/

Team Usage Flow

1. Start with wordpress-router or wp-project-triage to classify repository context.
2. Select the domain skill (theme, frontend, ops, review/migration).
3. Provide explicit inputs: URL/page type, file scope, and compatibility constraints.
4. Require explicit verification before merge or release.

Prompt examples:

• Use wordpress-router and wp-project-triage, then choose the right skill for this repository.
• Use classic-theme-dev to map URL -> template -> hook and implement the fix.
• Use wp-dev-workflow for a WordPress-focused code review with security and performance findings.

Skill Catalog

Routing and triage

• wordpress-router
• wp-project-triage

Theme development

• classic-theme-dev
• block-theme-dev
• wp-block-themes
• wp-block-development

Frontend

• frontend-wp
• wp-interactivity-api
• wpds

Tooling, ops, and quality

• wp-wpcli-and-ops
• wp-performance
• wp-phpstan
• wp-playground
• wp-dev-workflow

Recommended Team Bundles

• classic-theme-dev + frontend-wp + wp-dev-workflow
• block-theme-dev + wp-block-development + wp-interactivity-api
• wp-wpcli-and-ops + wp-performance + wp-phpstan

Dynamic Skill Modes

• theme-base (default): work in wp-content/themes/**, skip plugins.
• plugin-explicit (opt-in): include plugin scope only when explicitly requested.

Use plugin-explicit mode with triage:

npx wp-skills mode plugin-explicit

Use default theme-base mode:

npx wp-skills mode theme-base

Recommended plugin mode skills (external set):

• fullstack.wordpress.plugin-scaffold
• fullstack.wordpress.security-audit
• fullstack.wordpress.performance-audit
• wp-dev-workflow (for review and migration discipline)

Default guardrail remains:

• wp-content/plugins/ and wp-content/mu-plugins/ are treated as third-party and skipped unless plugin-explicit mode is requested.

Maintain and Validate

# Validate the skill set
node eval/harness/run.mjs

# List available skills from local repository
node shared/scripts/skillpack-install.mjs --list

Related docs:

• docs/authoring-guide.md
• docs/packaging.md
• docs/skill-set-v1.md