Skip to content
Back to search

agent-skills

SkillWorks with Claude CodeGitHub

Expert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/WordPress/agent-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/WordPress/agent-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/wordpress-agent-skills"><img src="/api/listings/wordpress-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.

The fastest way to install a skill is with a single command:

npx skills add WordPress/agent-skills --skill wp-plugin-development

To see all available skills:

npx skills add WordPress/agent-skills --list

To install multiple skills at once:

npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground

Choosing a scope

`npx skills add` asks to choose the skill **project-scoped**, selecting the local scope on which the skills are installed in the local project; it can be stored at the repository (e.g. `.claude/skills/`, `.cursor/skills/`) — so the skills can be committed to version control and shared with your team.

Installing **globally** makes the skill available to your user (across **all** your projects). Adding the `-g` / `--global` flag, it will install your skill with global scope:

npx skills add WordPress/agent-skills --skill wp-plugin-development --global

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/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,cursor

This 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)

Antigravity is opt-in for project-level installs. To also copy skills into `.agents/skills/`, include `antigravity` when building and installing:

node shared/scripts/skillpack-build.mjs --clean --targets=codex,vscode,claude,cursor,antigravity
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor,antigravity

Install globally for Cursor

node shared/scripts/skillpack-install.mjs --targets=cursor-global

This installs skills to `~/.cursor/skills/` where Cursor will discover them.

Install globally for Antigravity

node shared/scripts/skillpack-build.mjs --clean --targets=antigravity
node shared/scripts/skillpack-install.mjs --targets=antigravity-global

This installs skills to `~/.gemini/antigravity/skills/` where Antigravity 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-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 · 217 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Agent Skills for WordPress
  2. **Teach AI coding assistants how to build WordPress the right way.**
  3. 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.
  4. > **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](docs/ai-authorship.md) for details. ([WordPress AI Guidelines](https://make.wordpress.org/ai/handbook/ai-guidelines/))
  5. ## Why Agent Skills?
  6. AI coding assistants are powerful, but they often:
  7. - Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)
  8. - Miss critical security considerations in plugin development
  9. - Skip proper block deprecations, causing "Invalid block" errors
  10. - Ignore existing tooling in your repo
  11. Agent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use.
  12. ## Available Skills
  13. | Skill | What it teaches |
  14. |-------|-----------------|
  15. | **wordpress-router** | Classifies WordPress repos and routes to the right workflow |
  16. | **wp-project-triage** | Detects project type, tooling, and versions automatically |
  17. | **wp-block-development** | Gutenberg blocks: `block.json`, attributes, rendering, deprecations |
  18. | **wp-block-themes** | Block themes: `theme.json`, templates, patterns, style variations |
  19. | **wp-plugin-development** | Plugin architecture, hooks, settings API, security |
  20. | **wp-rest-api** | REST API routes/endpoints, schema, auth, and response shaping |
  21. | **wp-interactivity-api** | Frontend interactivity with `data-wp-*` directives and stores |
  22. | **wp-abilities-api** | Capability-based permissions and REST API authentication |
  23. | **wp-ability-development** | Design and review ability schemas, CRUD behavior, and permissions |
  24. | **wp-abilities-audit** | Audit a plugin's REST surface and propose Abilities API registrations |
  25. | **wp-abilities-verify** | Verify a plugin's Abilities API registrations against their declared annotations |
  26. | **wp-wpcli-and-ops** | WP-CLI commands, automation, multisite, search-replace |
  27. | **wp-performance** | Profiling, caching, database optimization, Server-Timing |
  28. | **wp-phpstan** | PHPStan static analysis for WordPress projects (config, baselines, WP-specific typing) |
  29. | **wp-playground** | WordPress Playground routing, CLI runs, browser previews, and snapshots |
  30. | **wpds** | WordPress Design System |
  31. | **wp-plugin-directory-guidelines** | WordPress Plugin Directory Guidelines |
  32. | **blueprint** | WordPress Playground Blueprints for declarative environment setup |
  33. | **wp-env** | Local WordPress development with `@wordpress/env`: setup, configuration, WP-CLI, Xdebug, troubleshooting |
  34. ## How It Works
  35. Each skill is a self-contained folder with instructions, references, and optional scripts:
  36. ```
  37. skills/wp-block-development/
  38. ├── SKILL.md # Main instructions (when to use, procedure, verification)
  39. ├── references/ # Deep-dive docs on specific topics
  40. │ ├── block-json.md
  41. │ ├── deprecations.md
  42. │ └── ...
  43. └── scripts/ # Deterministic helpers (detection, validation)
  44. └── list_blocks.mjs
  45. ```
  46. When you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing.
  47. ## Global vs. Project Scope
  48. Skills can be installed in two scopes:
  49. **Global** — installed in your home directory (e.g. `~/.claude/skills/`, `~/.cursor/skills/`).
  50. - Available across **all** your projects automatically.
  51. - Best for individual developers who want WordPress knowledge in every repo.
  52. **Project** — installed inside a repository (e.g. `.claude/skills/`, `.github/skills/`, `.cursor/skills/`).
  53. - Available only within **that specific project**.
  54. - Can be committed to version control so the entire team benefits.
  55. You can use both at the same time. When a skill exists in both scopes, the project-level version is used.
  56. ## Quick Start
  57. The fastest way to install a skill is with a single command:
  58. ```bash
  59. npx skills add WordPress/agent-skills --skill wp-plugin-development
  60. ```
  61. To see all available skills:
  62. ```bash
  63. npx skills add WordPress/agent-skills --list
  64. ```
  65. To install multiple skills at once:
  66. ```bash
  67. npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground
  68. ```
  69. #### Choosing a scope
  70. `npx skills add` asks to choose the skill **project-scoped**, selecting the local scope on which the skills are installed in the local project; it can be stored at the repository (e.g. `.claude/skills/`, `.cursor/skills/`) — so the skills can be committed to version control and shared with your team.
  71. Installing **globally** makes the skill available to your user (across **all** your projects). Adding the `-g` / `--global` flag, it will install your skill with global scope:
  72. ```bash
  73. npx skills add WordPress/agent-skills --skill wp-plugin-development --global
  74. ```
  75. ### Install globally for Claude Code
  76. ```bash
  77. # Clone agent-skills
  78. git clone https://github.com/WordPress/agent-skills.git
  79. cd agent-skills
  80. # Build the distribution
  81. node shared/scripts/skillpack-build.mjs --clean
  82. # Install all skills globally (available across all projects)
  83. node shared/scripts/skillpack-install.mjs --global
  84. # Or install specific skills only
  85. node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development
  86. ```
  87. This installs skills to `~/.claude/skills/` where Claude Code will automatically discover them.
  88. ### Install into your repo
  89. ```bash
  90. # Clone agent-skills
  91. git clone https://github.com/WordPress/agent-skills.git
  92. cd agent-skills
  93. # Build the distribution
  94. node shared/scripts/skillpack-build.mjs --clean
  95. # Install into your WordPress project
  96. node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor
  97. ```
  98. This copies skills into:
  99. - `.codex/skills/` for OpenAI Codex
  100. - `.github/skills/` for VS Code / GitHub Copilot
  101. - `.claude/skills/` for Claude Code (project-level)
  102. - `.cursor/skills/` for Cursor (project-level)
  103. Antigravity is opt-in for project-level installs. To also copy skills into `.agents/skills/`, include `antigravity` when building and installing:
  104. ```bash
  105. node shared/scripts/skillpack-build.mjs --clean --targets=codex,vscode,claude,cursor,antigravity
  106. node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor,antigravity
  107. ```
  108. ### Install globally for Cursor
  109. ```bash
  110. node shared/scripts/skillpack-install.mjs --targets=cursor-global
  111. ```
  112. This installs skills to `~/.cursor/skills/` where Cursor will discover them.
  113. ### Install globally for Antigravity
  114. ```bash
  115. node shared/scripts/skillpack-build.mjs --clean --targets=antigravity
  116. node shared/scripts/skillpack-install.mjs --targets=antigravity-global
  117. ```
  118. This installs skills to `~/.gemini/antigravity/skills/` where Antigravity will discover them.
  119. ### Available options
  120. ```bash
  121. # List available skills
  122. node shared/scripts/skillpack-install.mjs --list
  123. # Dry run (preview without installing)
  124. node shared/scripts/skillpack-install.mjs --global --dry-run
  125. # Install specific skills to a project (e.g. Claude + Cursor)
  126. node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cursor --skills=wp-wpcli-and-ops
  127. ```
  128. ### Manual installation
  129. Copy any skill folder from `skills/` into your project's instructions directory for your AI assistant.
  130. ## Compatibility
  131. - **WordPress 7.0+** (PHP 7.4.0+)
  132. - Works with any AI assistant that supports project-level instructions
  133. ## Contributing
  134. **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.
  135. See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.
  136. Quick commands:
  137. ```bash
  138. # Scaffold a new skill
  139. node shared/scripts/scaffold-skill.mjs <skill-name> "<description>"
  140. # Validate skills
  141. node shared/scripts/validate-skills.mjs
  142. ```
  143. This command validates skill metadata and the project-triage report. It does not execute the scenarios under `eval/scenarios/`; those currently require manual evaluation.
  144. ## Documentation
  145. - [Authoring Guide](docs/authoring-guide.md) - How to create and improve skills
  146. - [Principles](docs/principles.md) - Design philosophy
  147. - [Packaging](docs/packaging.md) - Build and distribution
  148. - [Compatibility Policy](docs/compatibility-policy.md) - Version targeting
  149. ## License
  150. GPL-2.0-or-later

Ratings and comments

Sign in to rate this skill.

Sign in

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