Skills · Publisher repository

Agent Skills for WordPress

An official WordPress organization collection of Agent Skills for project triage, blocks, themes, plugins, REST APIs, performance, and operations workflows.

2.2k StarsGPL-2.0-or-laterJavaScriptUpdated 2 days ago
01

Project overview

Agent Skills for WordPress is an open collection maintained by the official WordPress organization. It gives AI coding assistants that support project-level instructions access to WordPress core documentation, development conventions, checklists, and deterministic scripts. It spans project triage and routing, blocks, themes, plugins, REST APIs, the Interactivity API, performance, and WP-CLI operations. The reviewed commit contains 19 Skill directories. Adopt the smallest Skill that fits the task and confirm the installation scope first.

02

Core capabilities

01

Project triage and routing

wordpress-router and wp-project-triage inspect repository signals, produce structured triage results, and direct the task to a more specific WordPress Skill.

02

WordPress development workflows

The collection covers blocks, block themes, plugins, REST APIs, the Interactivity API, the Abilities API, Patterns, and the WordPress Design System.

03

Plugin security and quality checks

The plugin-development Skill covers capabilities, nonces, sanitization, escaping, SQL, lifecycle behavior, and related security references.

04

Performance and local operations

Performance, PHPStan, Playground, wp-env, and WP-CLI Skills support analysis and local workflows. The performance Skill requires confirmation for cache flushes, configuration changes, and plugin installation.

03

Installation and usage

List the available Skills and choose the smallest one first, then confirm project or global scope. Use npx for the normal path and build from source only when you need custom multi-host packaging.

AI AGENT INSTALL

Let an AI Agent install it

Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.

Help me evaluate and install Agent Skills for WordPress from https://github.com/WordPress/agent-skills. First read README.md, docs/compatibility-policy.md, docs/packaging.md, and LICENSE. Run `npx skills add WordPress/agent-skills --list` and inspect the target project's existing agent-configuration directories. Ask me to confirm the Skill, project or global scope, and target host. Do not overwrite files, write globally, modify WordPress, run WP-CLI, or request credentials without confirmation. After approval, use the exact documented npx command, start a new session, verify the directory, and run minimal read-only triage on a repository with no sensitive information. Clearly report anything that remains untested.
01Before you start
  • Node.js and npx; source installation also requires Git
  • A target WordPress project and write access to its agent-configuration directories
  • WordPress 7.0+ and PHP 7.4.0+, or a plan to handle version differences manually
  • A confirmed target host and project-level or global installation scope
02Copy the install command or configuration
npx skills add WordPress/agent-skills --list
03Complete the setup steps
  1. 1
    List and select a Skill

    Run `npx skills add WordPress/agent-skills --list` and select the smallest Skill for the task. Start with wp-plugin-development for plugin work or triage and routing for an unfamiliar project.

  2. 2
    Confirm the installation scope

    Inspect existing .codex, .github, .claude, or .cursor configuration and choose project-level installation or an explicitly approved --global installation.

  3. 3
    Run the documented installation

    For example, run `npx skills add WordPress/agent-skills --skill wp-plugin-development`. For multi-host packaging, follow the README build and install scripts with explicit targets.

  4. 4
    Start a new session and verify read-only behavior

    Confirm that Skill files were written to the intended directory, then run read-only triage on a non-sensitive test project. Do not run site-changing WP-CLI operations without authorization.

How to verify the setup

Start a new agent session after installation, confirm that the selected Skill exists in the expected directory, and ask the agent to perform read-only project triage on a WordPress repository with no sensitive data. Successful project identification and routing to an appropriate Skill is the minimal verification.

Before using it
  • Prefer only the Skill required for the current task
  • The --global option expands the write scope and requires confirmation
  • The installer replaces only the Skill directories it manages by default, but existing files should still be reviewed
  • WP-CLI, cache, configuration, and plugin changes on a real site need separate authorization
04

Use cases

SCENARIO 01

Create a plugin-development checklist

Have the agent review or implement a plugin against hooks, lifecycle behavior, the Settings API, capabilities, nonces, sanitization, and escaping.

SCENARIO 02

Identify an unfamiliar WordPress repository

Run deterministic triage first, then route the project to a block, theme, plugin, REST API, or operations Skill.

SCENARIO 03

Standardize instructions across agent hosts

Generate project-level Skill packages for Codex, VS Code, Claude Code, and Cursor from the same skills/ source tree.

05

Assessment

At the reviewed commit, the collection's main strengths are its official source, broad coverage, selectable installation scope, and explicit confirmation rules for security-sensitive and production write operations. The main uncertainties are the lack of formal releases, a small mismatch between the README and directory count, and manually oriented evaluation. Installation and runtime behavior were not tested for this catalog entry.

Why it may be useful

  • Maintained by the official WordPress organization with public sources and a compatibility policy
  • Supports individual Skill installation and multi-host project packages
  • Combines triage, development, security, performance, and local operations workflows
  • Clear GPL-2.0-or-later licensing

What to know first

  • No formal GitHub Release or tag
  • The README table omits the wp-patterns directory present in the reviewed tree
  • The project discloses that it does not yet have a formal automated evaluation system
  • This entry did not complete installation or a real WordPress scenario
06

README

Agent Skills for WordPress


Overview

An official WordPress organization collection of Agent Skills for project triage, blocks, themes, plugins, REST APIs, performance, and operations workflows. Expert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices

Getting started

  • List the available Skills and choose the smallest one first, then confirm project or global scope. Use npx for the normal path and build from source only when you need custom multi-host packaging.
  • The project splits WordPress expertise into composable Skills. Each Skill starts with a short SKILL.md and may include references and deterministic scripts.
  • The README documents npx commands for listing, single, multiple, and global installation, plus source builds for Codex, VS Code, Claude Code, and Cursor.
  • Start a new agent session after installation, confirm that the selected Skill exists in the expected directory, and ask the agent to perform read-only project triage on a WordPress repository with no sensitive data. Successful project identification and routing to an appropriate Skill is the minimal verification.

Configuration

npx skills add WordPress/agent-skills --list
Read the complete README on GitHub →