|
| 1 | +# AI Authorship Disclosure |
| 2 | + |
| 3 | +This document describes how AI tools were used to create the skills in this repository, in accordance with the [WordPress AI Guidelines](https://make.wordpress.org/ai/handbook/ai-guidelines/). |
| 4 | + |
| 5 | +## Summary |
| 6 | + |
| 7 | +| Aspect | Details | |
| 8 | +|--------|---------| |
| 9 | +| **AI Tool** | GPT-5.2 Codex (High Reasoning) | |
| 10 | +| **Source Material** | Official Gutenberg trunk documentation, WordPress developer docs | |
| 11 | +| **Human Review** | All skills reviewed and edited by WordPress contributors | |
| 12 | +| **Testing** | Skills tested with AI assistants (Claude, Copilot, Codex) | |
| 13 | +| **License** | GPL-2.0-or-later (compatible with WordPress) | |
| 14 | + |
| 15 | +## Process |
| 16 | + |
| 17 | +1. **Source Collection**: Up-to-date documentation was gathered from Gutenberg trunk and official WordPress developer resources. |
| 18 | + |
| 19 | +2. **AI Generation**: GPT-5.2 Codex (High Reasoning) processed the documentation to create semantically dense skill files, distilling large doc sets into actionable instructions AI assistants can follow. |
| 20 | + |
| 21 | +3. **Contributor Review**: WordPress contributors reviewed each skill for accuracy, alignment with current best practices, and completeness. |
| 22 | + |
| 23 | +4. **AI-Assisted Testing**: Skills were tested by using them with AI coding assistants (Codex and Claude Code) on real WordPress development tasks, sourced from [WP Bench](https://make.wordpress.org/ai/2026/01/14/introducing-wp-bench-a-wordpress-ai-benchmark/) to verify they produce correct guidance. That said, skills have not (yet) been run across a formal evaluation system, as one does not exist. |
| 24 | + |
| 25 | +5. **Iteration**: Based on testing results, skills were refined before the v1 release. |
| 26 | + |
| 27 | +## Per-Skill Breakdown |
| 28 | + |
| 29 | +All v1 skills followed the same process described above. As skills diverge in their development history, this table will be updated. |
| 30 | + |
| 31 | +| Skill | AI Generated | Human Reviewed | Tested | Notes | |
| 32 | +|-------|--------------|----------------|--------|-------| |
| 33 | +| wordpress-router | Yes | Yes | Yes | Routes to appropriate workflows | |
| 34 | +| wp-project-triage | Yes | Yes | Yes | Includes detection scripts | |
| 35 | +| wp-block-development | Yes | Yes | Yes | Core Gutenberg block patterns | |
| 36 | +| wp-block-themes | Yes | Yes | Yes | theme.json, templates, patterns | |
| 37 | +| wp-plugin-development | Yes | Yes | Yes | Hooks, settings API, security | |
| 38 | +| wp-rest-api | Yes | Yes | Yes | REST endpoints and auth | |
| 39 | +| wp-interactivity-api | Yes | Yes | Yes | data-wp-* directives | |
| 40 | +| wp-abilities-api | Yes | Yes | Yes | Capability-based permissions | |
| 41 | +| wp-wpcli-and-ops | Yes | Yes | Yes | CLI commands and automation | |
| 42 | +| wp-performance | Yes | Yes | Yes | Profiling, caching, optimization | |
| 43 | +| wp-phpstan | Yes | Yes | Yes | Static analysis configuration | |
| 44 | +| wp-playground | Yes | Yes | Yes | Local dev environments | |
| 45 | +| wpds | Yes | Yes | Yes | WordPress Design System | |
| 46 | + |
| 47 | +## Quality Commitment |
| 48 | + |
| 49 | +These skills are curated distillations of official documentation, reviewed by people who understand WordPress development. That said: |
| 50 | + |
| 51 | +- Skills will contain errors. Please [report issues](https://github.com/WordPress/agent-skills/issues). |
| 52 | +- Skills will improve over time as the community uses them and contributes fixes. |
| 53 | +- We welcome PRs that improve accuracy, fix outdated patterns, or add missing guidance. |
| 54 | + |
| 55 | +## Evolution |
| 56 | + |
| 57 | +This disclosure will be updated as: |
| 58 | +- Individual skills receive significant human rewrites |
| 59 | +- New skills are added with different authorship processes |
| 60 | +- Community feedback identifies areas needing clarification |
0 commit comments