firecrawl / agent-skills
✓ Official★ 3A skill package that teaches your agent 13 capabilities — every one documented and browsable below, no GitHub required · by firecrawl.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
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…
3 files — installable on its own
Use when working with the WordPress Abilities API (wp_register_ability, wp_register_ability_category, /wp-json/wp-abilities/v1/*, @wordpress/abilities)…
4 files — installable on its own
Use when developing WordPress (Gutenberg) blocks: block.json metadata, register_block_type(_from_metadata), attributes/serialization, supports, dynamic…
14 files — installable on its own
Use when developing WordPress block themes: theme.json (global settings/styles), templates and template parts, patterns, style variations, and Site Editor…
10 files — installable on its own
Use when building or debugging WordPress Interactivity API features (data-wp-* directives, @wordpress/interactivity store/state/actions, block viewScriptModule…
5 files — installable on its own
Use when investigating or improving WordPress performance (backend-only agent): profiling and measurement (WP-CLI profile/doctor, Server-Timing, Query Monitor…
14 files — installable on its own
Use when configuring, running, or fixing PHPStan static analysis in WordPress projects (plugins/themes/sites): phpstan.neon setup, baselines,…
7 files — installable on its own
Use for WordPress Playground workflows: fast disposable WP instances in the browser or locally via @wp-playground/cli (server, run-blueprint, build-snapshot),…
5 files — installable on its own
Use when developing WordPress plugins: architecture and hooks, activation/deactivation/uninstall, admin UI and Settings API, data storage, cron/tasks, security…
10 files — installable on its own
Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version…
5 files — installable on its own
Use when building, extending, or debugging WordPress REST API endpoints/routes: register_rest_route, WP_REST_Controller/controller classes, schema/argument…
8 files — installable on its own
Use when working with WP-CLI (wp) for WordPress operations: safe search-replace, db export/import, plugin/theme/user/content management, cron, cache flushing,…
11 files — installable on its own
Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.
1 file — installable on its own
Agent Skills for WordPress
Teach AI coding assistants how to build WordPress the right way.
Agent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Copilot, Codex, Cursor, etc.) understand WordPress development patterns, avoid common mistakes, and follow best practices.
AI Authorship Disclosure: These skills were generated using GPT-5.2 Codex (High Reasoning) from official Gutenberg and WordPress documentation, then reviewed and edited by WordPress contributors. We tested skills with AI assistants and iterated based on results. This is v1, and skills will improve as the community uses them and contributes fixes. See docs/ai-authorship.md for details. (WordPress AI Guidelines)
Why Agent Skills?
AI coding assistants are powerful, but they often:
- Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)
- Miss critical security considerations in plugin development
- Skip proper block deprecations, causing "Invalid block" errors
- Ignore existing tooling in your repo
Agent Skills solve this by giving AI assistants expert-level WordPress knowledge in a format they can actually use.
Available Skills
| Skill | What it teaches |
|---|---|
| wordpress-router | Classifies WordPress repos and routes to the right workflow |
| wp-project-triage | Detects project type, tooling, and versions automatically |
| wp-block-development | Gutenberg blocks: block.json, attributes, rendering, deprecations |
| wp-block-themes | Block themes: theme.json, templates, patterns, style variations |
| wp-plugin-development | Plugin architecture, hooks, settings API, security |
| wp-rest-api | REST API routes/endpoints, schema, auth, and response shaping |
| wp-interactivity-api | Frontend interactivity with data-wp-* directives and stores |
| wp-abilities-api | Capability-based permissions and REST API authentication |
| wp-wpcli-and-ops | WP-CLI commands, automation, multisite, search-replace |
| wp-performance | Profiling, caching, database optimization, Server-Timing |
| wp-phpstan | PHPStan static analysis for WordPress projects (config, baselines, WP-specific typing) |
| wp-playground | WordPress Playground for instant local environments |
| wpds | WordPress Design System |
Quick Start
Install globally for Claude Code
# Clone agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
# Build the distribution
node shared/scripts/skillpack-build.mjs --clean
# Install all skills globally (available across all projects)
node shared/scripts/skillpack-install.mjs --global
# Or install specific skills only
node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-developmentThis installs skills to ~/.claude/skills/ where Claude Code will automatically discover them.
Install into your repo
# Clone agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
# Build the distribution
node shared/scripts/skillpack-build.mjs --clean
# Install into your WordPress project
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursorThis copies skills into:
.codex/skills/for OpenAI Codex.github/skills/for VS Code / GitHub Copilot.claude/skills/for Claude Code (project-level).cursor/skills/for Cursor (project-level)
Install globally for Cursor
node shared/scripts/skillpack-install.mjs --targets=cursor-globalThis installs skills to ~/.cursor/skills/ where Cursor will discover them.
Available options
# List available skills
node shared/scripts/skillpack-install.mjs --list
# Dry run (preview without installing)
node shared/scripts/skillpack-install.mjs --global --dry-run
# Install specific skills to a project (e.g. Claude + Cursor)
node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cursor --skills=wp-wpcli-and-opsManual installation
Copy any skill folder from skills/ into your project's instructions directory for your AI assistant.
How It Works
Each skill contains:
skills/wp-block-development/
├── SKILL.md # Main instructions (when to use, procedure, verification)
├── references/ # Deep-dive docs on specific topics
│ ├── block-json.md
│ ├── deprecations.md
│ └── ...
└── scripts/ # Deterministic helpers (detection, validation)
└── list_blocks.mjsWhen you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing.
Compatibility
- WordPress 6.9+ (PHP 7.2.24+)
- Works with any AI assistant that supports project-level instructions
Contributing
We welcome contributions! This project is a great way to share your WordPress expertise—you don't need to be a coding wizard. Most skills are written in Markdown, focusing on clear procedures and best practices.
See CONTRIBUTING.md for details on how to get started.
Quick commands:
# Scaffold a new skill
node shared/scripts/scaffold-skill.mjs <skill-name> "<description>"
# Validate skills
node eval/harness/run.mjsDocumentation
- Authoring Guide - How to create and improve skills
- Principles - Design philosophy
- Packaging - Build and distribution
- Compatibility Policy - Version targeting
License
GPL-2.0-or-later
Install the whole package (13 skills):
npx skills add https://github.com/firecrawl/agent-skillsOr install a single skill:
npx skills add https://github.com/firecrawl/agent-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.