Skip to content

Commit 6a63013

Browse files
committed
Add AI authorship disclosure per WordPress AI Guidelines
Adds disclosure to README and creates docs/ai-authorship.md with detailed breakdown of how skills were created, reviewed, and tested. Fixes #6
1 parent 8a7a7fe commit 6a63013

2 files changed

Lines changed: 62 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
Agent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Copilot, Codex, Cursor, etc.) understand WordPress development patterns, avoid common mistakes, and follow best practices.
66

7+
> **AI Authorship Disclosure:** These skills were generated using GPT-5.2 Codex (High Reasoning) from official Gutenberg and WordPress documentation, then reviewed and edited by WordPress contributors. We tested skills with AI assistants and iterated based on results. This is v1, and skills will improve as the community uses them and contributes fixes. See [docs/ai-authorship.md](docs/ai-authorship.md) for details. ([WordPress AI Guidelines](https://make.wordpress.org/ai/handbook/ai-guidelines/))
8+
79
## Why Agent Skills?
810

911
AI coding assistants are powerful, but they often:

‎docs/ai-authorship.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
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

Comments
 (0)