Skip to content
Back to search

wordpress-dev-skills

MarketplaceWorks with Claude CodeGitHub

Agent Skills for WordPress and WooCommerce developers.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/saizul--wordpress-dev-skills"><img src="/api/listings/saizul--wordpress-dev-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code: plugin marketplace (recommended)

/plugin marketplace add saizul/wordpress-dev-skills
/plugin install wp-dev@wordpress-dev-skills

Or from your shell: `claude plugin marketplace add saizul/wordpress-dev-skills` then `claude plugin install wp-dev@wordpress-dev-skills`. Skills are namespaced by the plugin, for example `/wp-dev:wp-security-review`. Update later with `/plugin marketplace update`.

Claude Code: copy skills manually

git clone https://github.com/saizul/wordpress-dev-skills
# for you, in every project:
mkdir -p ~/.claude/skills && cp -r wordpress-dev-skills/skills/* ~/.claude/skills/
# or for one project (commit it so your team gets them):
mkdir -p .claude/skills && cp -r wordpress-dev-skills/skills/wp-security-review .claude/skills/

Each release also attaches one zip per skill and an all-skills zip.

OpenAI Codex

Codex reads skills from `.agents/skills` in your repository (and parent directories up to the repo root) and from `$HOME/.agents/skills` for your user ([Codex skills docs](https://developers.openai.com/codex/skills)):

git clone https://github.com/saizul/wordpress-dev-skills
mkdir -p ~/.agents/skills && cp -r wordpress-dev-skills/skills/* ~/.agents/skills/
# or per repository:
mkdir -p .agents/skills && cp -r wordpress-dev-skills/skills/wp-cli-ops .agents/skills/

Restart Codex if a new skill does not show up. See [AGENTS.md](AGENTS.md) for how agents should use the skills.

Other agents

The skills follow the open [Agent Skills format](https://agentskills.io/specification): a folder with `SKILL.md` (YAML frontmatter + instructions) and optional `scripts/` and `references/`. Any client that supports the format can load them; the scripts also run on their own:

python3 skills/wp-security-review/scripts/wp_security_scan.py path/to/plugin --format sarif

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.

.claude-plugin/marketplace.json · Manifest · 30 lines
  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "wordpress-dev-skills",
  4. "description": "Agent Skills for WordPress and WooCommerce developers.",
  5. "owner": {
  6. "name": "Saizul Amin",
  7. "url": "https://github.com/saizul"
  8. },
  9. "plugins": [
  10. {
  11. "name": "wp-dev",
  12. "source": "./",
  13. "description": "8 WordPress skills: plugin scaffold, security review, WP-CLI ops, performance audit, block dev, WooCommerce/HPOS, hardening, readme.txt.",
  14. "category": "development",
  15. "tags": ["wordpress", "woocommerce", "wp-cli", "gutenberg", "security"],
  16. "metadata": {
  17. "skills": [
  18. "wp-plugin-scaffold",
  19. "wp-security-review",
  20. "wp-cli-ops",
  21. "wp-performance-audit",
  22. "wp-block-dev",
  23. "woocommerce-dev",
  24. "wp-hardening",
  25. "wp-readme-txt"
  26. ]
  27. }
  28. }
  29. ]
  30. }
README.md · README · 187 lines
  1. # WordPress Dev Skills
  2. [![CI](https://github.com/saizul/wordpress-dev-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/saizul/wordpress-dev-skills/actions/workflows/ci.yml)
  3. [![Release](https://img.shields.io/github/v/release/saizul/wordpress-dev-skills?sort=semver)](https://github.com/saizul/wordpress-dev-skills/releases)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. [![Stars](https://img.shields.io/github/stars/saizul/wordpress-dev-skills?style=social)](https://github.com/saizul/wordpress-dev-skills/stargazers)
  6. **Agent Skills that make Claude Code, Codex and other coding agents work like a senior
  7. WordPress developer: secure by default, WP-CLI safe, HPOS-ready.**
  8. Eight focused skills, each with a step-by-step workflow, checklists and a tested,
  9. dependency-free helper script (Python 3 stdlib). Scripts are read-only or dry-run by
  10. default and never print secrets.
  11. ## Skills
  12. | Skill | What it does | Try asking |
  13. | --- | --- | --- |
  14. | [wp-plugin-scaffold](skills/wp-plugin-scaffold/SKILL.md) | Generates a modern plugin: namespaces, Composer PSR-4 + fallback autoloader, Settings API page, PHPCS (WordPress-Extra), PHPUnit + Brain Monkey, GitHub Actions, readme.txt | "Scaffold a plugin called Acme Reviews with namespace Acme\Reviews" |
  15. | [wp-security-review](skills/wp-security-review/SKILL.md) | Audits escaping, sanitizing, nonces, capabilities, `$wpdb->prepare()`, REST `permission_callback`; scanner with 18 rules, JSON and SARIF output | "Security-review wp-content/plugins/my-plugin before I submit it" |
  16. | [wp-cli-ops](skills/wp-cli-ops/SKILL.md) | Safe WP-CLI recipes; plans domain migrations with backup, dry runs and JSON-escaped/URL-encoded variants | "Move this site from staging.example.com to example.com" |
  17. | [wp-performance-audit](skills/wp-performance-audit/SKILL.md) | Server-side performance audit; analyzes `wp option list` output for autoload bloat | "Why is TTFB 2 seconds? Here is wp option list output" |
  18. | [wp-block-dev](skills/wp-block-dev/SKILL.md) | block.json (apiVersion 3), dynamic blocks, @wordpress/scripts, deprecations, Interactivity API; block.json validator | "Create a dynamic block that lists the latest 3 reviews" |
  19. | [woocommerce-dev](skills/woocommerce-dev/SKILL.md) | CRUD-first WooCommerce code, hook map, HPOS and Cart/Checkout blocks compatibility; HPOS scanner | "Make my extension HPOS compatible" |
  20. | [wp-hardening](skills/wp-hardening/SKILL.md) | wp-config constants, permissions, leaked files, XML-RPC, REST user enumeration, security headers; wp-config checker | "Harden this WordPress install at /var/www/site" |
  21. | [wp-readme-txt](skills/wp-readme-txt/SKILL.md) | Generates and validates WordPress.org readme.txt (tags, 150-char short description, Stable tag vs Version) | "Prepare readme.txt for the 1.2.0 release" |
  22. ## Install
  23. ### Claude Code: plugin marketplace (recommended)
  24. ```text
  25. /plugin marketplace add saizul/wordpress-dev-skills
  26. /plugin install wp-dev@wordpress-dev-skills
  27. ```
  28. Or from your shell: `claude plugin marketplace add saizul/wordpress-dev-skills` then
  29. `claude plugin install wp-dev@wordpress-dev-skills`. Skills are namespaced by the plugin,
  30. for example `/wp-dev:wp-security-review`. Update later with `/plugin marketplace update`.
  31. ### Claude Code: copy skills manually
  32. ```bash
  33. git clone https://github.com/saizul/wordpress-dev-skills
  34. # for you, in every project:
  35. mkdir -p ~/.claude/skills && cp -r wordpress-dev-skills/skills/* ~/.claude/skills/
  36. # or for one project (commit it so your team gets them):
  37. mkdir -p .claude/skills && cp -r wordpress-dev-skills/skills/wp-security-review .claude/skills/
  38. ```
  39. Each release also attaches one zip per skill and an all-skills zip.
  40. ### OpenAI Codex
  41. Codex reads skills from `.agents/skills` in your repository (and parent directories up
  42. to the repo root) and from `$HOME/.agents/skills` for your user
  43. ([Codex skills docs](https://developers.openai.com/codex/skills)):
  44. ```bash
  45. git clone https://github.com/saizul/wordpress-dev-skills
  46. mkdir -p ~/.agents/skills && cp -r wordpress-dev-skills/skills/* ~/.agents/skills/
  47. # or per repository:
  48. mkdir -p .agents/skills && cp -r wordpress-dev-skills/skills/wp-cli-ops .agents/skills/
  49. ```
  50. Restart Codex if a new skill does not show up. See [AGENTS.md](AGENTS.md) for how agents
  51. should use the skills.
  52. ### Other agents
  53. The skills follow the open [Agent Skills format](https://agentskills.io/specification):
  54. a folder with `SKILL.md` (YAML frontmatter + instructions) and optional `scripts/` and
  55. `references/`. Any client that supports the format can load them; the scripts also run
  56. on their own:
  57. ```bash
  58. python3 skills/wp-security-review/scripts/wp_security_scan.py path/to/plugin --format sarif
  59. ```
  60. ## Usage examples
  61. ```text
  62. > Review the AJAX handlers in includes/ for security problems and fix what you find.
  63. (wp-security-review: runs the scanner, triages findings, checks each entry point)
  64. > We are moving shop.example.com to example.com tonight. Give me the exact commands.
  65. (wp-cli-ops: backup, dry runs for plain/JSON-escaped/URL-encoded URLs, apply, verify)
  66. > wp option list --fields=option_name,size_bytes,autoload --format=json > options.json
  67. > Analyze options.json and tell me what to turn off.
  68. (wp-performance-audit: totals, top options, owner prefixes, safe set-autoload commands)
  69. ```
  70. Script cheat sheet (all support `--help`, `--json`, and non-zero exit codes for CI):
  71. | Script | Purpose | Exit 1 when |
  72. | --- | --- | --- |
  73. | `wp-plugin-scaffold/scripts/scaffold_plugin.py` | create a plugin | target files exist (no `--force`) |
  74. | `wp-security-review/scripts/wp_security_scan.py` | security scanner (text/JSON/SARIF) | findings >= `--fail-on` |
  75. | `wp-cli-ops/scripts/search_replace_plan.py` | migration plan | warnings with `--strict` |
  76. | `wp-performance-audit/scripts/analyze_options.py` | autoload analysis | over threshold / large options |
  77. | `wp-block-dev/scripts/validate_block_json.py` | block.json validator | errors (or warnings with `--strict`) |
  78. | `woocommerce-dev/scripts/hpos_check.py` | HPOS scanner | findings >= `--fail-on` |
  79. | `wp-hardening/scripts/check_wp_config.py` | wp-config and web root audit | findings >= `--fail-on` |
  80. | `wp-readme-txt/scripts/readme_txt.py` | readme.txt generate/validate | errors (or warnings with `--strict`) |
  81. Use them in your plugin's CI, for example:
  82. ```yaml
  83. - name: Security scan (fails the job on high/critical findings)
  84. run: python3 wordpress-dev-skills/skills/wp-security-review/scripts/wp_security_scan.py . --fail-on high
  85. - name: SARIF for GitHub code scanning
  86. if: always()
  87. run: python3 wordpress-dev-skills/skills/wp-security-review/scripts/wp_security_scan.py . --format sarif > wpsec.sarif || true
  88. - uses: github/codeql-action/upload-sarif@v3
  89. if: always()
  90. with: { sarif_file: wpsec.sarif }
  91. ```
  92. ## How skills work
  93. At startup the agent only sees each skill's `name` and `description` (a few dozen
  94. tokens). When your request matches a description, it loads that `SKILL.md`, follows the
  95. workflow, and opens `references/*.md` or runs `scripts/*` only when a step needs them.
  96. That keeps context small while giving the agent precise, tested procedures instead of
  97. guesses.
  98. ```
  99. skills/wp-security-review/
  100. SKILL.md when to use, workflow, checklist, output format
  101. scripts/wp_security_scan.py
  102. references/patterns.md, references/rules.md
  103. ```
  104. ## FAQ
  105. **Do the scripts need anything installed?** Python 3.9+ only. Generated plugins need
  106. Composer to install PHPCS/PHPUnit; block development needs Node for `@wordpress/scripts`.
  107. **Will they change my site?** No script writes to a database or a live site. The
  108. scaffold writes new files (never overwrites without `--force`); the readme generator
  109. writes only with `-o`. WP-CLI commands are printed for you to review, with writing
  110. steps marked.
  111. **Is the security scanner a replacement for PHPCS or a pentest?** No. It is a fast,
  112. explainable first pass that points at lines to read. The skill tells the agent to
  113. triage every finding and to run PHPCS with the WordPress security sniffs.
  114. **Do secrets ever leave my machine?** The scripts make no network calls, and the
  115. wp-config checker reports only whether secrets are set, never their values.
  116. **Can I use only one skill?** Yes. Copy a single folder; each is self-contained.
  117. ## Roadmap
  118. Ideas for new skills and features. Issues tagged
  119. [good first issue](https://github.com/saizul/wordpress-dev-skills/labels/good%20first%20issue)
  120. are a great place to start:
  121. - [ ] `wp-theme-json`: build and validate theme.json for block themes
  122. - [ ] `wp-rest-api`: design custom endpoints, schemas and authentication (application passwords, JWT)
  123. - [ ] `wp-multisite-ops`: network-wide WP-CLI recipes and domain mapping
  124. - [ ] `wp-i18n`: make-pot/make-json workflow, text domain checker script
  125. - [ ] `wp-env-testing`: `@wordpress/env` + integration tests + Playwright e2e
  126. - [ ] `wp-cron-debug`: script to analyze `wp cron event list` output for duplicates
  127. - [ ] `woocommerce-payments-dev`: payment gateway skeleton with Store API/blocks support
  128. - [ ] Security scanner: heredoc support and taint tracking across lines in one function
  129. - [x] HPOS scanner: detect `$wpdb->postmeta` joins for order meta
  130. ## Contributing
  131. New skills, rules and fixes are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md), copy
  132. [templates/skill/SKILL.md](templates/skill/SKILL.md), then run:
  133. ```bash
  134. python -m pip install ruff pytest
  135. python tools/validate_skills.py && pytest && ruff check . && ruff format --check .
  136. ```
  137. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md) and report vulnerabilities
  138. privately as described in [SECURITY.md](SECURITY.md).
  139. ## License
  140. [MIT](LICENSE) © Saizul Amin. WordPress is a registered trademark of the WordPress
  141. Foundation; this project is not affiliated with or endorsed by it, Automattic or
  142. WooCommerce.

Ratings and comments

Sign in to rate this skill.

Sign in

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