Agent Skills for WordPress

The community hub for WordPress AI workflows.

Skills that run inside Claude Code, Codex, Antigravity, Cursor, and any AI agent that supports Skills + MCP to analyze, audit, optimize, and fix WordPress sites.
Built by the community. Curated by Respira. Open source.

Live Directory: https://www.respira.press/skills

What Are Skills?

Skills teach AI agents how to work with WordPress in ways that respect your site's architecture and your need for control.

Plain AI agent: Generic guidance based on best practices
Respira-powered skills: Deep site access via 197 MCP tools, 302 with the WooCommerce add-on

Installation

npx skills (recommended)

Works with Claude Code, OpenCode, Codex and anything else that reads the Skills format. Tracks what you installed, from where, and at what content hash, so installs are reproducible and updates are one command.

# Install every skill globally
npx skills add respira-press/agent-skills-wordpress -g -a claude-code -y

# Or into the current project only
npx skills add respira-press/agent-skills-wordpress -a claude-code -y

# Update later
npx skills update -g

Swap -a claude-code for your agent, for example -a opencode.

Installing writes a lock file recording each skill's source, skillPath and computedHash, so you can tell exactly which version of a skill you are running and whether it has changed upstream.

From inside WordPress

If you run the Respira plugin, the Skills screen in wp-admin installs and updates these without touching a terminal.

Manual

git clone https://github.com/respira-press/agent-skills-wordpress
cp -r agent-skills-wordpress/skills/* ~/.claude/skills/

Available Skills

Onboarding

Site Onboarding
First-run primer: verifies MCP connection, discovers site architecture, maps all capabilities, recommends marketplace skills.
By Respira for WordPress

Audit Skills

WordPress Site DNA
Comprehensive site archaeology: builders, plugins, content structure, technical debt.
By Respira for WordPress

Technical Debt Audit
Finds orphaned shortcodes, unused plugins, database bloat, inactive builder data.
By Respira for WordPress

WooCommerce Health Check
Store diagnostics: checkout issues, cart problems, payment gateway configuration.
By Respira for WordPress · Requires WooCommerce add-on

Mobile Experience Report
Mobile layout analysis: responsive breakpoints, touch targets, navigation issues.
By Respira for WordPress

Performance Skills

SEO & AEO Amplifier
On-page SEO and Answer Engine Optimization with automated schema generation.
By Respira for WordPress

WordPress AI Image Optimizer
AI-powered image optimization: compress, convert to WebP, resize, rename, alt text, and update references.
By Respira for WordPress

Internal Link Builder
Strategic internal link building: scans content, maps topic relationships, finds linking opportunities, applies with duplicate-first safety.
By Respira for WordPress

Migration Skills

AI-powered page builder migrations. Each skill parses source builder content, maps modules to target equivalents, creates draft duplicates, and writes clean target-format content. Originals are never modified.

Browse all migrations: https://www.respira.press/skills/migrations

From Elementor

Target Skill Coverage
Gutenberg Migrate Elementor to Gutenberg 80-90% of standard widgets
Bricks Migrate Elementor to Bricks 85-95% of standard widgets
Breakdance Migrate Elementor to Breakdance 80-90% of standard widgets
Oxygen Migrate Elementor to Oxygen 75-85% of standard widgets

From Divi

Target Skill Coverage
Gutenberg Migrate Divi to Gutenberg 75-85% of standard modules
Bricks Migrate Divi to Bricks 75-85% of standard modules
Breakdance Migrate Divi to Breakdance 75-85% of standard modules

From WPBakery

Target Skill Coverage
Gutenberg Migrate WPBakery to Gutenberg 70-80% of standard elements
Bricks Migrate WPBakery to Bricks 75-85% of standard elements

From Oxygen

Target Skill Coverage
Bricks Migrate Oxygen to Bricks 80-90% of standard components
Breakdance Migrate Oxygen to Breakdance 80-90% of standard components

From Beaver Builder

Target Skill Coverage
Gutenberg Migrate Beaver Builder to Gutenberg 75-85% of standard modules
Bricks Migrate Beaver Builder to Bricks 80-90% of standard modules

From Other Builders

Source Target Skill Coverage
Brizy Gutenberg Migrate Brizy to Gutenberg 70-80% of standard elements
Thrive Architect Gutenberg Migrate Thrive Architect to Gutenberg 65-75% of standard elements
Visual Composer Gutenberg Migrate Visual Composer to Gutenberg 70-80% of standard elements

Content & Portability

Content Portability
Export WordPress content to portable local packages with builder data, media, and markdown previews. Import to another site with smart ID remapping. Auto-backup before AI edits. Diff local exports against live site.
By Respira for WordPress

Skill Structure

Each skill follows Anthropic's official format:

skills/skill-name/
├── SKILL.md (with YAML frontmatter - main instructions)
├── references/ (optional - detailed docs)
│   ├── example-output.md
│   └── technical-details.md
└── scripts/ (optional - executable code)

No README.md or metadata.json inside skill folders - all documentation goes in SKILL.md or references/

Contributing

We want skills that solve real problems on real WordPress sites.

See CONTRIBUTING.md for:

  • How to submit a skill
  • Quality standards
  • Skill structure requirements
  • Recognition and rewards

Quick start:

  1. Fork this repo
  2. Create your skill in skills/your-skill-name/
  3. Include SKILL.md with YAML frontmatter
  4. Test on 3+ real WordPress sites
  5. Submit PR

Read Full Guidelines →

Recognition

Accepted skills get:

  • Featured in https://respira.press/skills directory
  • Author attribution with link to your site/GitHub
  • Usage stats shared monthly
  • Promotion in newsletter and social channels
  • Your name in contributors list

Support

Questions?

Found a bug in a skill?
Open an issue with the skill name in the title.

Want to improve a skill?
Fork, improve, submit PR. Tag original author if possible.

License

All skills are MIT licensed. By contributing, you agree to license your skill under MIT.

Directory

Browse all skills: https://www.respira.press/skills

Built by the WordPress community. Curated by Respira for WordPress.