| name | wp-add-skills |
| description | Install official WordPress agent-skills from the WordPress/agent-skills GitHub repository. Invoke when user asks to install WordPress skills, says "add WordPress skills", "install WordPress agent skills", or uses /wp-add-skills. Has side effects: clones a repository, installs 13 skills to the global skills directory. Requires user confirmation before installation. Supports --list and --update flags. |
| disable-model-invocation | true |
WP Add Skills
Install official WordPress agent-skills from the WordPress/agent-skills repository.
⚠️ Side Effect Warning
This skill installs software to your system:
- Clones the WordPress/agent-skills repository (~28 seconds download)
- Runs npm build scripts (~14 seconds)
- Installs 13 skills to your global skills directory
- Temporary files are cleaned up after installation
Installation paths differ by environment (see Tier 1 vs Tier 2 below).
Confirmation required before installation begins.
Usage
- "Install WordPress agent skills"
/wp-add-skills — Install 13 WordPress skills
/wp-add-skills --list — List installed WordPress skills
/wp-add-skills --update — Update to latest version
Prerequisites
- Git 2.0+ (
git --version)
- Node.js v16+ (
node --version) — v18 or v20 recommended
- Disk space — At least 100MB available in home directory
- Write permissions to the skills directory
Environment Detection
Tier 1 — Portable (Codex and other environments)
Skills install path: ~/.agents/skills/ (Codex standard path)
- Parse flags — Determine if --list, --update, or install
- For --list: Show installed skills in
~/.agents/skills/ that match WordPress pattern
- For install/update:
- Present confirmation:
This will install 13 WordPress skills to ~/.agents/skills/
Prerequisites needed: git 2.0+, Node.js v16+, ~100MB disk space
Reply "confirm" to proceed, "cancel" to abort.
- ⛔ STOP: Wait for confirmation
- After confirmation, provide manual installation steps if Bash unavailable:
git clone --depth 1 https://github.com/WordPress/agent-skills /tmp/wp-skills-install
cd /tmp/wp-skills-install
node skillpack-build.mjs --clean
node skillpack-install.mjs --global --path ~/.agents/skills/
rm -rf /tmp/wp-skills-install
Tier 2 — Claude Code Enhanced
Skills install path: ~/.claude/skills/ (Claude Code path)
- Parse flags
- For --list:
ls -la ~/.claude/skills/ | grep wp- || echo "No WordPress skills installed"
- For install/update:
- Check prerequisites:
git --version && node --version && df -h ~ | tail -1
- Present confirmation with prereq status:
Installing 13 WordPress skills to ~/.claude/skills/
Prerequisites:
✅ Git: {version}
✅ Node.js: {version}
✅ Disk space: {available}
Reply "confirm" to proceed, "cancel" to abort.
- ⛔ STOP: Wait for confirmation
- After confirmation, execute installation:
git clone --depth 1 https://github.com/WordPress/agent-skills /tmp/wp-skills-$(date +%s)
cd /tmp/wp-skills-*
node skillpack-build.mjs --clean
node skillpack-install.mjs --global
ls ~/.claude/skills/ | grep -c "" | xargs echo "Skills installed:"
rm -rf /tmp/wp-skills-*
The 13 WordPress Skills
- wordpress-router — WordPress project detection and routing
- wp-project-triage — Auto-detect WordPress tooling, versions, configuration
- wp-block-development — Gutenberg block development (block.json, InnerBlocks, transforms)
- wp-block-themes — Block themes and theme.json
- wp-plugin-development — Plugin architecture, hooks, actions, filters, security
- wp-rest-api — REST API endpoints, authentication, custom routes
- wp-interactivity-api — Frontend directives (@wordpress/interactivity)
- wp-abilities-api — User capabilities and permissions system
- wp-wpcli-and-ops — WP-CLI commands, automation, operations
- wp-performance — Performance optimization, caching, database queries
- wp-phpstan — Static analysis configuration for WordPress
- wp-playground — WordPress Playground integration and testing
- wpds — WordPress Design System components and patterns
Installation Timing (~70 seconds total)
| Step | Duration |
|---|
| Prerequisites check | ~2s |
| Clone repository | ~28s |
| Build skills | ~14s |
| Install globally | ~2s |
| Verify installation | ~1s |
| Cleanup | ~1s |
Success Report
✅ Installation Complete!
Installed: 13 WordPress skills
Location: {skills-directory}
Total time: ~70 seconds
Next steps:
- Test: "How do I create a custom Gutenberg block?"
- List skills: wp-add-skills --list
Troubleshooting
- Node.js too old: Update to v18 or v20 LTS
- Permission denied:
chmod 755 {skills-directory}
- Clone failed: Check internet connection, try again
- Skills don't appear: Restart your AI session after installation
Related Skills
- wp-block-development — One of the installed WordPress skills
- wp-plugin-development — One of the installed WordPress skills