Agent Skills for WordPress

Official WordPress skill set for AI assistants: blocks, themes, plugins, REST API, WP-CLI and performance

  • 2,354 ★ on the repository
  • Last commit
SkillEditors’ pick

Extended access

Why this level

  • Scripts run in Node.js and scan project files
  • Some skills drive WP-CLI operations that can change a WordPress database
All reasons and checks

wordpress/agent-skills

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/agent-skills-for-wordpress

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Scripts run in Node.js and scan project files
  • Some skills drive WP-CLI operations that can change a WordPress database

This is third-party code. Review the repository files before installing.

What it does

The WordPress set gives an AI assistant ready procedures for WordPress work instead of guessing from memory. It covers Gutenberg blocks, block themes, patterns, plugins, REST API, the Interactivity API, the Abilities API, WP-CLI, performance, PHPStan and WordPress Playground, plus a router skill that classifies the repository and points to the right procedure. Each skill is a folder with a SKILL.md file, topic references and, for some, deterministic scripts that scan the project. Skills install globally or inside a repository and work in Claude Code, Cursor, Codex, VS Code and Copilot.

Who it is for. For WordPress developers who build blocks, themes and plugins with an AI assistant.

Good fit when

  • You develop a WordPress block, theme or plugin and want the agent to follow current practices
  • You need to avoid the Invalid block error when changing markup and add correct deprecations
  • You need safe WP-CLI operations, REST API work or performance profiling

Not a fit when

  • The project is not WordPress
  • Your agent does not support project-level skills or instructions

Example request

Add a dynamic Gutenberg block with render.php and set up deprecations so existing posts do not break

Limitations

These are instructions and helper scripts, not a WordPress plugin: they help only inside an agent that can read project-level skills. The material targets WordPress 7.0+ and PHP 7.4+. The v1 skills were generated by AI from official docs and edited by contributors, who plan to improve them over time. Scripts run in Node.js.

How to disable. Remove the copied skill folders from ~/.claude/skills/ or from the project's skills directory (.claude/skills/, .cursor/skills/, .codex/skills/, .github/skills/).

FAQ

Do I have to install every skill?

No. With npx skills add or the install script you can pick only the ones you need, for example wp-block-development and wp-playground.

Which agents does it work with?

Any that read project-level skills or instructions: Claude Code, Cursor, Codex, VS Code and Copilot. The install script lays skills into each one's directory.

Discussion

No questions or reviews yet.

Skills

55 skills for Claude Code, Codex and Cursor covering WordPress audits, edits, migrations and page builds through Respira MCP.

PluginBroad access51Repository stars

15 skills for Claude Code and Codex: Laravel, Docker, UI, debugging, tests and docs in four ready plugin bundles

PluginExtended access69Repository stars

Builder Skills

Skills for agents

A set of small skills from Builder.io for agent work habits: visual plans and diff recaps, docs-first checks, cross-agent review and clean status updates

SkillExtended access4.7KRepository stars

Softaworks Agent Toolkit

Softaworks Agent Skills

A marketplace of skills, subagents and commands for coding agents: development, documentation, planning and workplace communication

PluginExtended access2.7KRepository stars

The CLI gives agents WordPress maintenance commands for plugins, configuration, content and site data through the terminal.

CLIBroad access5.2KRepository stars

24 skills for Laravel, PHP, React and TypeScript: code rules, testing, security, technical debt and documentation.

SkillMinimal access103Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Agent Skills for WordPress (this card)no2,354
Novamira: an MCP server for WordPressnoOAuth765a WordPress plugin with an MCP server
WP-CLIno5,179The CLI gives agents WordPress maintenance commands for plugins, configuration, content and site data through the terminal.

README in short

The README presents the skills as portable bundles of instructions, references and scripts that teach an AI assistant to build WordPress by current rules and avoid outdated patterns. A table lists the skills: router, project triage, blocks, block themes, patterns, plugins, REST and Interactivity APIs, the Abilities API and its audit, WP-CLI, performance, PHPStan, Playground, the design system and plugin directory guidelines. Install paths are shown: the npx skills add command, build and install via scripts in shared/scripts, and manual folder copying. Skills install globally or into a specific repository and can be committed for the team. Licensed GPL-2.0-or-later.

README badge

Original SKILL.md

---
name: wp-block-development
description: "Use when developing WordPress (Gutenberg) blocks: block.json metadata, register_block_type(_from_metadata), attributes/serialization, supports, dynamic rendering (render.php/render_callback), deprecations/migrations, viewScript vs viewScriptModule, and @wordpress/scripts/@wordpress/create-block build and test workflows."
compatibility: "Targets WordPress 7.0+ (PHP 7.4.0+). Filesystem-based agent with bash + node. Some workflows require WP-CLI."
---

# WP Block Development

## When to use

Use this skill for block work such as:

- creating a new block, or updating an existing one
- changing block.json (scripts/styles/supports/attributes/render/viewScriptModule)
- fixing block invalid / not saving / attributes not persisting
- adding dynamic rendering (render.php / render_callback)
- block deprecations and migrations (deprecated versions)
- build tooling for blocks (@wordpress/scripts, @wordpress/create-block, wp-env)

## Inputs required

- Repo root and target (plugin vs theme vs full site).
- The block name/namespace and where it lives (path to block.json if known).
- Target WordPress version range (especially if using modules / viewScriptModule).

## Procedure

### 0) Triage and locate blocks

1. Run triage: node skills/wp-project-triage/scripts/detect_wp_project.mjs
2. List blocks (deterministic scan): node skills/wp-block-development/scripts/list_blocks.mjs
3. Identify the block root (directory containing block.json) you are changing.

Report a problem