Updated 4d ago
by WordPress
agent-skills
Expert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices
2.2k GitHub stars (2,245)
+75 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | +2 |
| Sep 28 | +3 |
| Sep 29 | +3 |
| Sep 30 | +7 |
| Oct 1 | +1 |
| Oct 2 | +6 |
| Oct 3 | 0 |
| Oct 4 | +1 |
| Oct 5 | +5 |
| Oct 6 | +3 |
| Oct 7 | +7 |
| Oct 8 | +1 |
| Oct 9 | +2 |
| Oct 10 | +5 |
| Oct 11 | +6 |
| Oct 12 | +4 |
| Oct 13 | +6 |
| Oct 14 | +4 |
| Oct 15 | +6 |
| Oct 16 | +3 |
- 19 skills (19 skills found in its SKILL.md files)
- 331 forks (331 forks)
- 4d ago last update (Last updated 4d ago)
Install
Skills CLI
npx skills add WordPress/agent-skills
Asks which skills and agents to install. Just one: npx skills add WordPress/agent-skills --skill blueprint — add -g for every project.
Claude Code
git clone https://github.com/WordPress/agent-skillscp -r "agent-skills/skills/blueprint" ~/.claude/skills/
Copies the blueprint skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add WordPress/agent-skills
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
blueprint
Use when the deliverable is WordPress Playground Blueprint JSON or a Blueprint bundle, including creating, editing, reviewing, validating schema keys, choosing steps/resources, and debugging Blueprint files. For only running or sharing a Playground environment, use wp-playground.
skills/blueprint/SKILL.md on GitHub (opens in a new tab) -
wordpress-router
Use when the user asks about WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and you need to quickly classify the repo and route to the correct workflow/skill (blocks, theme.json, REST API, WP-CLI, performance, security, testing, release packaging).
skills/wordpress-router/SKILL.md on GitHub (opens in a new tab) -
wp-abilities-api
Use when working with the WordPress Abilities API (wp_register_ability, wp_register_ability_category, /wp-json/wp-abilities/v1/*, @wordpress/abilities) including defining abilities, categories, meta, REST exposure, and permissions checks for clients.
skills/wp-abilities-api/SKILL.md on GitHub (opens in a new tab) -
wp-abilities-audit
Audit a WordPress plugin's REST surface and produce a standardized audit document proposing Abilities API registrations. Produces a markdown doc with a YAML schema and prose sections that humans and agents can both consume when planning a registration rollout. Works on any WP plugin.
skills/wp-abilities-audit/SKILL.md on GitHub (opens in a new tab) -
wp-abilities-verify
Verify a WordPress plugin's Abilities API registrations: enumerate abilities, check that callback behavior matches each annotation's claim (the adversarial readonly-but-writes detection), validate permissions and schemas, and validate audit documents produced by wp-abilities-audit.
skills/wp-abilities-verify/SKILL.md on GitHub (opens in a new tab) -
wp-block-development
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.
skills/wp-block-development/SKILL.md on GitHub (opens in a new tab) -
wp-block-themes
Use when developing WordPress block themes: theme.json (global settings/styles), templates and template parts, patterns, style variations, and Site Editor troubleshooting (style hierarchy, overrides, caching).
skills/wp-block-themes/SKILL.md on GitHub (opens in a new tab) -
wp-env
Use when setting up, configuring, or troubleshooting local WordPress development environments with @wordpress/env (wp-env). Triggers on mentions of wp-env, local WordPress development, Docker-based WordPress, or requests to start/stop/configure a local WordPress instance.
skills/wp-env/SKILL.md on GitHub (opens in a new tab) -
wp-interactivity-api
Use when building or debugging WordPress Interactivity API features (data-wp-* directives, @wordpress/interactivity store/state/actions, block viewScriptModule integration, wp_interactivity_*()) including performance, hydration, and directive behavior.
skills/wp-interactivity-api/SKILL.md on GitHub (opens in a new tab) -
wp-patterns
Pattern: create or update WordPress block patterns (starter pages, templates, template parts, Query Loop layouts), review pattern registration, block markup, categories, accessibility, or i18n/escaping, or improve pattern design quality. Route custom blocks to wp-block-development; route frontend interactivity to wp-interactivity-api.
skills/wp-patterns/SKILL.md on GitHub (opens in a new tab) -
wp-performance
Use when investigating or improving WordPress performance (backend-only agent): profiling and measurement (WP-CLI profile/doctor, Server-Timing, Query Monitor via REST headers), database/query optimization, autoloaded options, object caching, cron, HTTP API calls, and safe verification.
skills/wp-performance/SKILL.md on GitHub (opens in a new tab) -
wp-phpstan
Use when configuring, running, or fixing PHPStan static analysis in WordPress projects (plugins/themes/sites): phpstan.neon setup, baselines, WordPress-specific typing, and handling third-party plugin classes.
skills/wp-phpstan/SKILL.md on GitHub (opens in a new tab) -
wp-playground
Use as the WordPress Playground routing wrapper for ambiguous Playground work, local CLI runs with @wp-playground/cli, playground.wordpress.net share links, browser previews, WebMCP site tools, snapshots, mounts, version switching, and Xdebug. For Blueprint JSON authoring or review, use the blueprint skill directly.
skills/wp-playground/SKILL.md on GitHub (opens in a new tab) -
wp-plugin-development
Use when developing WordPress plugins: architecture and hooks, activation/deactivation/uninstall, admin UI and Settings API, data storage, cron/tasks, security (nonces/capabilities/sanitization/escaping), and release packaging.
skills/wp-plugin-development/SKILL.md on GitHub (opens in a new tab) -
wp-plugin-directory-guidelines
Use when reviewing WordPress plugins for GPL compliance, checking license headers or compatibility, evaluating upsell/freemium/trialware patterns, validating plugin naming or trademark rules, checking plugin slugs, understanding why a plugin was rejected from WordPress.org, or answering any question about the 18 WordPress.org Plugin Directory guidelines — even if the user doesn't mention 'guideli…
skills/wp-plugin-directory-guidelines/SKILL.md on GitHub (opens in a new tab) -
wp-project-triage
Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version hints, and a structured JSON report to guide workflows and guardrails.
skills/wp-project-triage/SKILL.md on GitHub (opens in a new tab) -
wp-rest-api
Use when building, extending, or debugging WordPress REST API endpoints/routes: register_rest_route, WP_REST_Controller/controller classes, schema/argument validation, permission_callback/authentication, response shaping, register_rest_field/register_meta, or exposing CPTs/taxonomies via show_in_rest.
skills/wp-rest-api/SKILL.md on GitHub (opens in a new tab) -
wp-wpcli-and-ops
Use when working with WP-CLI (wp) for WordPress operations: safe search-replace, db export/import, plugin/theme/user/content management, cron, cache flushing, multisite, and scripting/automation with wp-cli.yml.
skills/wp-wpcli-and-ops/SKILL.md on GitHub (opens in a new tab) -
wpds
Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.
skills/wpds/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.