wordpress-router — Claude Code skill: what it does, how to install
Identifies the structure of a WordPress codebase and directs the agent to the appropriate workflow. Useful before starting work on plugins, themes, or core checkouts.
npx skills add WordPress/agent-skills --skill wordpress-router -a claude-codeWhat wordpress-router does
The skill executes node skills/wp-project-triage/scripts/detect_wp_project.mjs to classify the current workspace. It checks whether the project is a plugin, a block theme, or a core checkout. It also detects tooling like Composer, Node, @wordpress/scripts, and test suites like PHPUnit. It prevents misdirected edits.
Next, it reads skills/wordpress-router/references/decision-tree.md to map the task to domain-specific instructions. The skill targets WordPress 7.0+ and PHP 7.4.0+. An environment with bash and Node.js is required, while certain routines also expect WP-CLI. Massive repositories will slow down triage unless you configure ignore rules.
What it helps with
- classify the repository type across plugins, themes, and core checkouts
- identify active build tools and test suites like PHPUnit or wp-env
- route the agent through the appropriate decision tree
- guard against version mismatches on WordPress codebases
Example prompts for the agent
- Triage this repository and detect whether it is a plugin or a theme.
- Inspect the WordPress project structure and report available test runners.
- Route this Gutenberg block task to the appropriate workflow.
How to install wordpress-router
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wordpress-router -a claude-code2Manually: put the files in place
~/.claude/skills/wordpress-router/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wordpress-router/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wordpress-router -a codex2Manually: put the files in place
.agents/skills/wordpress-router/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wordpress-router -a cursor2Manually: put the files in place
.cursor/skills/wordpress-router/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wordpress-router2Manually: put the files in place
.github/skills/wordpress-router/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wordpress-router -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wordpress-routerManually: put the files in place
.devin/skills/wordpress-router/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wordpress-router -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set8
The whole set →Similar
Questions about wordpress-router
How do I install wordpress-router in Claude Code?
Run npx skills add WordPress/agent-skills --skill wordpress-router -a claude-code.
What does wordpress-router do?
It runs a project triage script to identify the WordPress project type and routes tasks using a structured decision tree.
What prerequisites does this skill require?
It needs bash, Node.js, and a project targeting WordPress 7.0+ with PHP 7.4.0+. Selected workflows also require WP-CLI.