Wordpress Router
This is basically a traffic cop for WordPress projects. It runs a triage script that sniffs your repo to figure out whether you're working on a plugin, a block theme, a core checkout, or something else, then routes you to the right specialized workflow. The decision tree lives in references/decision-tree.md and helps you land on the correct domain skill for blocks, theme.json, REST API work, WP-CLI tasks, or release packaging. Targets WordPress 6.9+ and expects bash plus node. Honest take: if you're jumping between different kinds of WordPress codebases, this saves you from manually explaining the project structure every time. The triage output also flags tooling and tests so you don't have to hunt for what's already set up.
- skills.sh installs
- 456
- GitHub stars
- 211
- last updated
- Jun 3, 2026
Install
$ npx -y skills add automattic/agent-skills --skill wordpress-router --agent claude-codeInstalls into .claude/skills of the current project.
Files
WordPress Router
When to use
Use this skill at the start of most WordPress tasks to:
- identify what kind of WordPress codebase this is (plugin vs theme vs block theme vs WP core checkout vs full site),
- pick the right workflow and guardrails,
- delegate to the most relevant domain skill(s).
Inputs required
- Repo root (current working directory).
- The user’s intent (what they want changed) and any constraints (WP version targets, WP.com specifics, release requirements).
Procedure
- Run the project triage script:
node skills/wp-project-triage/scripts/detect_wp_project.mjs
- Read the triage output and classify:
- primary project kind(s),
- tooling available (PHP/Composer, Node, @wordpress/scripts),
- tests present (PHPUnit, Playwright, wp-env),
- any version hints.
- Route to domain workflows based on user intent + repo kind:
- For the decision tree, read:
skills/wordpress-router/references/decision-tree.md.
- For the decision tree, read:
- Apply guardrails before making changes:
- Confirm any version constraints if unclear.
- Prefer the repo’s existing tooling and conventions for builds/tests.
Verification
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/automattic/agent-skills
- Categories
- AI & Agent Building, PHP & Laravel
- First seen
- Jun 3, 2026
More from automattic/agent-skills
All 12Recommended
More AI & Agent Building
cpu-profilingaj-geddes/useful-ai-promptsProfile CPU usage to identify hot spots and bottlenecks. Optimize code paths consuming most CPU time for better performance and resource efficiency.455skills.sh installssecurity-documentationaj-geddes/useful-ai-promptsCreate security policies, guidelines, compliance documentation, and security best practices. Use when documenting security policies, compliance requirements, or455skills.sh installs
publish-x-articlesugarforever/01coder-agent-skillsPublish Markdown articles to X (Twitter) Articles editor with proper formatting. Use when user wants to publish a Markdown file/URL to X Articles, or mentions "455skills.sh installsfrontend-routingaj-geddes/useful-ai-promptsImplement client-side routing using React Router, Vue Router, and Angular Router. Use when building multi-page applications with navigation and route protection454skills.sh installsload-balancer-setupaj-geddes/useful-ai-promptsConfigure and deploy load balancers (HAProxy, AWS ELB/ALB/NLB) for distributing traffic, session management, and high availability.454skills.sh installsproperty-based-testingaj-geddes/useful-ai-promptsDesign property-based tests that verify code properties hold for all inputs using automatic test case generation. Use for property-based, QuickCheck, hypothesis454skills.sh installs