# wordpress/agent-skills architecture

> Architecture diagram of the GitHub repository wordpress/agent-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wordpress/agent-skills
- Repository: https://github.com/wordpress/agent-skills

## Overview

Agent Skills for WordPress is a portable knowledge library for AI coding assistants. The principal workflow is an assistant using a skill to guide WordPress work; the router classifies a repository and directs work toward relevant workflows, while project triage detects project type, tooling, and versions. Skills cover development, operations, audits, and design, with optional inspection helpers and an installer for assistant-specific destinations. Relationships among individual skills are not established by the supplied excerpts, so the graph avoids inferring calls or routing between them.

Main entry points: [`skills/wordpress-router/SKILL.md`](https://github.com/wordpress/agent-skills/blob/trunk/skills/wordpress-router/SKILL.md) (Workflow Router), [`skills/wp-project-triage/SKILL.md`](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/SKILL.md) (Project Triage), [`skills/wp-project-triage/scripts/detect_wp_project.mjs`](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/scripts/detect_wp_project.mjs) (Project Detector), [`shared/scripts/skillpack-install.mjs`](https://github.com/wordpress/agent-skills/blob/trunk/shared/scripts/skillpack-install.mjs) (Skill Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and Setup"]
  node_router["Workflow Router<br/>[SKILL.md]"]
  node_triage["Project Triage<br/>[SKILL.md]"]
  node_triage_tool["Project Detector"]
  node_installer["Skill Installer"]
end

subgraph group_development["WordPress Development"]
  node_blocks["Block Development<br/>[SKILL.md]"]
  node_block_tool["Block Inventory<br/>[list_blocks.mjs]"]
  node_plugins["Plugin Development<br/>[SKILL.md]"]
  node_rest["REST API<br/>[SKILL.md]"]
  node_interactivity["Interactivity API<br/>[SKILL.md]"]
  node_abilities["Abilities API<br/>[SKILL.md]"]
end

subgraph group_operations["Operations and Audits"]
  node_wpcli["WP-CLI and Ops<br/>[SKILL.md]"]
  node_wpcli_tool["WP-CLI Inspector<br/>[wpcli_inspect.mjs]"]
  node_performance["Performance<br/>[SKILL.md]"]
  node_performance_tool["Performance Inspector<br/>[perf_inspect.mjs]"]
  node_phpstan["PHPStan<br/>[SKILL.md]"]
  node_phpstan_tool["PHPStan Inspector"]
  node_abilities_audit["Abilities Audit<br/>[SKILL.md]"]
  node_abilities_verify["Abilities Verify<br/>[SKILL.md]"]
  node_plugin_guidelines["Directory Guidelines<br/>[SKILL.md]"]
end

subgraph group_design["Design and Experience"]
  node_themes["Block Themes<br/>[SKILL.md]"]
  node_theme_tool["Theme Detector"]
  node_patterns["Block Patterns<br/>[SKILL.md]"]
  node_playground["WordPress Playground<br/>[SKILL.md]"]
  node_blueprint["Playground Blueprints<br/>[SKILL.md]"]
  node_wp_env["Local WP Environment<br/>[SKILL.md]"]
  node_wpds["WordPress Design System<br/>[SKILL.md]"]
end

node_assistant(("AI Assistant"))

node_assistant -->|"uses workflow"| node_router
node_assistant -->|"uses skill"| node_triage
node_assistant -->|"uses skill"| node_blocks
node_assistant -->|"uses skill"| node_plugins
node_assistant -->|"uses skill"| node_rest
node_assistant -->|"uses skill"| node_interactivity
node_assistant -->|"uses skill"| node_abilities
node_assistant -->|"uses skill"| node_wpcli
node_assistant -->|"uses skill"| node_performance
node_assistant -->|"uses skill"| node_phpstan
node_assistant -->|"uses skill"| node_abilities_audit
node_assistant -->|"uses skill"| node_abilities_verify
node_assistant -->|"uses skill"| node_plugin_guidelines
node_assistant -->|"uses skill"| node_themes
node_assistant -->|"uses skill"| node_patterns
node_assistant -->|"uses skill"| node_playground
node_assistant -->|"uses skill"| node_blueprint
node_assistant -->|"uses skill"| node_wp_env
node_assistant -->|"uses skill"| node_wpds
node_assistant -.->|"runs detector"| node_triage_tool
node_assistant -.->|"runs inspector"| node_block_tool
node_assistant -.->|"runs inspector"| node_theme_tool
node_assistant -.->|"runs inspector"| node_wpcli_tool
node_assistant -.->|"runs inspector"| node_performance_tool
node_assistant -.->|"runs inspector"| node_phpstan_tool
node_assistant -->|"installs skills"| node_installer

click node_router "https://github.com/wordpress/agent-skills/blob/trunk/skills/wordpress-router/SKILL.md"
click node_triage "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/SKILL.md"
click node_triage_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/scripts/detect_wp_project.mjs"
click node_installer "https://github.com/wordpress/agent-skills/blob/trunk/shared/scripts/skillpack-install.mjs"
click node_blocks "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-development/SKILL.md"
click node_block_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-development/scripts/list_blocks.mjs"
click node_plugins "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-plugin-development/SKILL.md"
click node_rest "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-rest-api/SKILL.md"
click node_interactivity "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-interactivity-api/SKILL.md"
click node_abilities "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-api/SKILL.md"
click node_wpcli "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-wpcli-and-ops/SKILL.md"
click node_wpcli_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs"
click node_performance "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-performance/SKILL.md"
click node_performance_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-performance/scripts/perf_inspect.mjs"
click node_phpstan "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-phpstan/SKILL.md"
click node_phpstan_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-phpstan/scripts/phpstan_inspect.mjs"
click node_abilities_audit "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-audit/SKILL.md"
click node_abilities_verify "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-verify/SKILL.md"
click node_plugin_guidelines "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-plugin-directory-guidelines/SKILL.md"
click node_themes "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-themes/SKILL.md"
click node_theme_tool "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-themes/scripts/detect_block_themes.mjs"
click node_patterns "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-patterns/SKILL.md"
click node_playground "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-playground/SKILL.md"
click node_blueprint "https://github.com/wordpress/agent-skills/blob/trunk/skills/blueprint/SKILL.md"
click node_wp_env "https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-env/SKILL.md"
click node_wpds "https://github.com/wordpress/agent-skills/blob/trunk/skills/wpds/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_triage,node_triage_tool,node_installer toneBlue
class node_blocks,node_block_tool,node_plugins,node_rest,node_interactivity,node_abilities toneAmber
class node_wpcli,node_wpcli_tool,node_performance,node_performance_tool,node_phpstan,node_phpstan_tool,node_abilities_audit,node_abilities_verify,node_plugin_guidelines toneMint
class node_themes,node_theme_tool,node_patterns,node_playground,node_blueprint,node_wp_env,node_wpds toneRose
class node_assistant toneIndigo
```

## Components

### Routing and Setup

- [Workflow Router](https://github.com/wordpress/agent-skills/blob/trunk/skills/wordpress-router/SKILL.md): `skills/wordpress-router/SKILL.md`
- [Project Triage](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/SKILL.md): `skills/wp-project-triage/SKILL.md`
- [Project Detector](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-project-triage/scripts/detect_wp_project.mjs): `skills/wp-project-triage/scripts/detect_wp_project.mjs`
- [Skill Installer](https://github.com/wordpress/agent-skills/blob/trunk/shared/scripts/skillpack-install.mjs): `shared/scripts/skillpack-install.mjs`

### WordPress Development

- [Block Development](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-development/SKILL.md): `skills/wp-block-development/SKILL.md`
- [Block Inventory](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-development/scripts/list_blocks.mjs): `skills/wp-block-development/scripts/list_blocks.mjs`
- [Plugin Development](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-plugin-development/SKILL.md): `skills/wp-plugin-development/SKILL.md`
- [REST API](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-rest-api/SKILL.md): `skills/wp-rest-api/SKILL.md`
- [Interactivity API](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-interactivity-api/SKILL.md): `skills/wp-interactivity-api/SKILL.md`
- [Abilities API](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-api/SKILL.md): `skills/wp-abilities-api/SKILL.md`

### Operations and Audits

- [WP-CLI and Ops](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-wpcli-and-ops/SKILL.md): `skills/wp-wpcli-and-ops/SKILL.md`
- [WP-CLI Inspector](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs): `skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs`
- [Performance](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-performance/SKILL.md): `skills/wp-performance/SKILL.md`
- [Performance Inspector](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-performance/scripts/perf_inspect.mjs): `skills/wp-performance/scripts/perf_inspect.mjs`
- [PHPStan](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-phpstan/SKILL.md): `skills/wp-phpstan/SKILL.md`
- [PHPStan Inspector](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-phpstan/scripts/phpstan_inspect.mjs): `skills/wp-phpstan/scripts/phpstan_inspect.mjs`
- [Abilities Audit](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-audit/SKILL.md): `skills/wp-abilities-audit/SKILL.md`
- [Abilities Verify](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-abilities-verify/SKILL.md): `skills/wp-abilities-verify/SKILL.md`
- [Directory Guidelines](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-plugin-directory-guidelines/SKILL.md): `skills/wp-plugin-directory-guidelines/SKILL.md`

### Design and Experience

- [Block Themes](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-themes/SKILL.md): `skills/wp-block-themes/SKILL.md`
- [Theme Detector](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-block-themes/scripts/detect_block_themes.mjs): `skills/wp-block-themes/scripts/detect_block_themes.mjs`
- [Block Patterns](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-patterns/SKILL.md): `skills/wp-patterns/SKILL.md`
- [WordPress Playground](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-playground/SKILL.md): `skills/wp-playground/SKILL.md`
- [Playground Blueprints](https://github.com/wordpress/agent-skills/blob/trunk/skills/blueprint/SKILL.md): `skills/blueprint/SKILL.md`
- [Local WP Environment](https://github.com/wordpress/agent-skills/blob/trunk/skills/wp-env/SKILL.md): `skills/wp-env/SKILL.md`
- [WordPress Design System](https://github.com/wordpress/agent-skills/blob/trunk/skills/wpds/SKILL.md): `skills/wpds/SKILL.md`

### Other components

- **AI Assistant**

## Connections

- AI Assistant → Workflow Router: uses workflow (evidence: `README.md`)
- AI Assistant → Project Triage: uses skill (evidence: `README.md`)
- AI Assistant → Block Development: uses skill (evidence: `README.md`)
- AI Assistant → Plugin Development: uses skill (evidence: `README.md`)
- AI Assistant → REST API: uses skill (evidence: `README.md`)
- AI Assistant → Interactivity API: uses skill (evidence: `README.md`)
- AI Assistant → Abilities API: uses skill (evidence: `README.md`)
- AI Assistant → WP-CLI and Ops: uses skill (evidence: `README.md`)
- AI Assistant → Performance: uses skill (evidence: `README.md`)
- AI Assistant → PHPStan: uses skill (evidence: `README.md`)
- AI Assistant → Abilities Audit: uses skill (evidence: `README.md`)
- AI Assistant → Abilities Verify: uses skill (evidence: `README.md`)
- AI Assistant → Directory Guidelines: uses skill (evidence: `README.md`)
- AI Assistant → Block Themes: uses skill (evidence: `README.md`)
- AI Assistant → Block Patterns: uses skill (evidence: `README.md`)
- AI Assistant → WordPress Playground: uses skill (evidence: `README.md`)
- AI Assistant → Playground Blueprints: uses skill (evidence: `README.md`)
- AI Assistant → Local WP Environment: uses skill (evidence: `README.md`)
- AI Assistant → WordPress Design System: uses skill (evidence: `README.md`)
- AI Assistant → Project Detector: runs detector
- AI Assistant → Block Inventory: runs inspector
- AI Assistant → Theme Detector: runs inspector
- AI Assistant → WP-CLI Inspector: runs inspector
- AI Assistant → Performance Inspector: runs inspector
- AI Assistant → PHPStan Inspector: runs inspector
- AI Assistant → Skill Installer: installs skills (evidence: `README.md`)