Summary

This repository provides expert-level WordPress knowledge as portable "Agent Skills" for AI coding assistants. It aims to improve AI-generated WordPress code by teaching assistants correct patterns, security considerations, and best practices, thereby reducing common errors and enhancing development efficiency for AI-assisted WordPress projects.

How It Works

The project packages WordPress development expertise into modular "skills," which are collections of instructions, checklists, and scripts. AI coding assistants (like Claude, Copilot, Codex) read these skills to understand and apply WordPress-specific patterns, from Gutenberg blocks and themes to plugin development and security, directly within their coding workflows. This approach bypasses AI's tendency to generate outdated or insecure code by providing explicit, expert guidance.

Quick Start & Requirements

• Primary install/run: Clone the repository and use provided Node.js scripts (skillpack-build.mjs, skillpack-install.mjs) for global or project-level skill installation.
• Prerequisites: Node.js.
• Compatibility: WordPress 6.9+ (PHP 7.2.24+).
• Links: CONTRIBUTING.md, Documentation Authoring Guide, Principles, Packaging, Compatibility Policy.

Highlighted Details

• Offers a comprehensive suite of skills including: repository routing, project triage, Gutenberg block development (block.json, attributes, rendering, deprecations), block themes (theme.json, templates, patterns), plugin architecture, REST API, Interactivity API, Abilities API, WP-CLI, performance optimization, PHPStan static analysis, WordPress Playground, and the WordPress Design System (WPDS).
• Each skill comprises main instructions, deep-dive references, and deterministic helper scripts for AI consumption.
• Designed for seamless integration with AI assistants supporting project-level instructions.

Maintenance & Community

Contributions are welcomed, with detailed guidance in CONTRIBUTING.md. The README does not specify community channels (e.g., Discord, Slack) or notable maintainers/sponsors.

Licensing & Compatibility

• License: GPL-2.0-or-later.
• Compatibility: Compatible with WordPress 6.9+. The GPL-2.0-or-later license implies copyleft restrictions, potentially affecting integration with closed-source projects.

Limitations & Caveats

The utility of these skills is contingent upon the AI assistant's capability to effectively process and act upon project-level instructions. Installation and build processes require Node.js. The README does not provide specific benchmarks or resource requirements for skill execution.