Skip to content
Back to search

agent-skills

Agent Skills for WordPress - folders of instructions, scripts, and resources

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/automattic--agent-skills/badge.svg)](/listings/automattic--agent-skills)

HTML

<a href="/listings/automattic--agent-skills"><img src="/api/listings/automattic--agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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-development

This installs skills to `~/.claude/skills/` where Claude Code will automatically discover them.

Install into your repo

# Clone agent-skills
git clone https://github.com/Automattic/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

This copies skills into: - `.codex/skills/` for OpenAI Codex - `.github/skills/` for VS Code / GitHub Copilot - `.claude/skills/` for Claude Code (project-level)

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
node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude --skills=wp-wpcli-and-ops

Manual installation

Copy any skill folder from `skills/` into your project's instructions directory for your AI assistant.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agent Skills for WordPress
  2. > **⚠️ This repository has moved to [WordPress/agent-skills](https://github.com/WordPress/agent-skills)**
  3. >
  4. > This repository is now archived. All future development happens in the WordPress organization.
  5. > Please update your bookmarks, clones, and references to use the new repository.
  6. **Teach AI coding assistants how to build WordPress the right way.**
  7. 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.
  8. <img width="2400" height="1260" alt="Agent Skills banner" src="https://github.com/user-attachments/assets/def9a6f9-cbba-4249-866f-b9a274b84188" />
  9. ## Why Agent Skills?
  10. AI coding assistants are powerful, but they often:
  11. - Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)
  12. - Miss critical security considerations in plugin development
  13. - Skip proper block deprecations, causing "Invalid block" errors
  14. - Ignore existing tooling in your repo
  15. Agent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use.
  16. ## Available Skills
  17. | Skill | What it teaches |
  18. |-------|-----------------|
  19. | **wordpress-router** | Classifies WordPress repos and routes to the right workflow |
  20. | **wp-project-triage** | Detects project type, tooling, and versions automatically |
  21. | **wp-block-development** | Gutenberg blocks: `block.json`, attributes, rendering, deprecations |
  22. | **wp-block-themes** | Block themes: `theme.json`, templates, patterns, style variations |
  23. | **wp-plugin-development** | Plugin architecture, hooks, settings API, security |
  24. | **wp-rest-api** | REST API routes/endpoints, schema, auth, and response shaping |
  25. | **wp-interactivity-api** | Frontend interactivity with `data-wp-*` directives and stores |
  26. | **wp-abilities-api** | Capability-based permissions and REST API authentication |
  27. | **wp-wpcli-and-ops** | WP-CLI commands, automation, multisite, search-replace |
  28. | **wp-performance** | Profiling, caching, database optimization, Server-Timing |
  29. | **wp-phpstan** | PHPStan static analysis for WordPress projects (config, baselines, WP-specific typing) |
  30. | **wp-playground** | WordPress Playground for instant local environments |
  31. | **wpds** | WordPress Design System |
  32. ## Quick Start
  33. ### Install globally for Claude Code
  34. ```bash
  35. # Clone agent-skills
  36. git clone https://github.com/WordPress/agent-skills.git
  37. cd agent-skills
  38. # Build the distribution
  39. node shared/scripts/skillpack-build.mjs --clean
  40. # Install all skills globally (available across all projects)
  41. node shared/scripts/skillpack-install.mjs --global
  42. # Or install specific skills only
  43. node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development
  44. ```
  45. This installs skills to `~/.claude/skills/` where Claude Code will automatically discover them.
  46. ### Install into your repo
  47. ```bash
  48. # Clone agent-skills
  49. git clone https://github.com/Automattic/agent-skills.git
  50. cd agent-skills
  51. # Build the distribution
  52. node shared/scripts/skillpack-build.mjs --clean
  53. # Install into your WordPress project
  54. node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude
  55. ```
  56. This copies skills into:
  57. - `.codex/skills/` for OpenAI Codex
  58. - `.github/skills/` for VS Code / GitHub Copilot
  59. - `.claude/skills/` for Claude Code (project-level)
  60. ### Available options
  61. ```bash
  62. # List available skills
  63. node shared/scripts/skillpack-install.mjs --list
  64. # Dry run (preview without installing)
  65. node shared/scripts/skillpack-install.mjs --global --dry-run
  66. # Install specific skills to a project
  67. node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude --skills=wp-wpcli-and-ops
  68. ```
  69. ### Manual installation
  70. Copy any skill folder from `skills/` into your project's instructions directory for your AI assistant.
  71. ## How It Works
  72. Each skill contains:
  73. ```
  74. skills/wp-block-development/
  75. ├── SKILL.md # Main instructions (when to use, procedure, verification)
  76. ├── references/ # Deep-dive docs on specific topics
  77. │ ├── block-json.md
  78. │ ├── deprecations.md
  79. │ └── ...
  80. └── scripts/ # Deterministic helpers (detection, validation)
  81. └── list_blocks.mjs
  82. ```
  83. When you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing.
  84. ## Compatibility
  85. - **WordPress 6.9+** (PHP 7.2.24+)
  86. - Works with any AI assistant that supports project-level instructions
  87. ## Contributing
  88. **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.
  89. See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.
  90. Quick commands:
  91. ```bash
  92. # Scaffold a new skill
  93. node shared/scripts/scaffold-skill.mjs <skill-name> "<description>"
  94. # Validate skills
  95. node eval/harness/run.mjs
  96. ```
  97. ## Documentation
  98. - [Authoring Guide](docs/authoring-guide.md) - How to create and improve skills
  99. - [Principles](docs/principles.md) - Design philosophy
  100. - [Packaging](docs/packaging.md) - Build and distribution
  101. - [Compatibility Policy](docs/compatibility-policy.md) - Version targeting
  102. ## License
  103. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.