wiki: full-page audit 2026-05-17 — refresh stale counts + fix spec drift
Triggered by the repo quality audit (000-docs/266-RA-AUDT-...) which
initially mis-flagged the wiki as "empty" (API check was the wrong
proxy — wiki has 47 pages). The real finding: the wiki is rich but
stale.
## Numeric refresh (23 pages touched)
- Plugin count: 343 → 427
- Skill count: 1,900+ → 2,747
- Version: v4.17.0 → v4.30.0
- Categories: 22 / 26 → 18 (current actual)
- "340+ plugins" → "427+ plugins"
## Spec drift fixes (architectural — the dangerous kind)
The wiki was teaching the OLD validation rules. A new contributor
following these would get rejected by the current validator:
1. **`allowed-tools` was documented as "MUST be CSV string; YAML
arrays cause parse errors"** — false as of schema 3.6.0. Both CSV
string AND YAML list are valid. Many shipped plugins use the YAML
list form. Fixed in:
- SKILL-md-Specification.md (3 occurrences)
- Frontmatter-Reference.md (2 occurrences)
- Glossary.md, Lab-Architecture.md, Lab-Build-Your-Own.md
- FAQ.md, Validation-and-Grading.md
2. **"6 required fields" was documented everywhere** — current
marketplace tier requires 8 (added `compatibility` and `tags`).
Fixed in: FAQ, Lab-Architecture, Lab-Build-Your-Own, Lab-Debugging,
Troubleshooting, Glossary.
3. **`compatible-with` was documented as the current field** —
deprecated in schema 3.4.0; the current field is `compatibility`
(free-text per agentskills.io). Added explicit deprecation note in
Frontmatter-Reference.md; replaced examples elsewhere.
## Not touched
- Changelog.md (historical record, should not be rewritten)
- Per-Playbook pages (didn't reference any of the stale numbers)
- Per-Plugin entries in Plugin-Inventory (auto-generated; refreshed
via separate sync if needed)
Refs the repo audit doc at
000-docs/266-RA-AUDT-repo-quality-audit-2026-05-17.md.
feat: complete wiki expansion — 48 new pages, inventory system, generation script
Add all missing wiki pages to resolve 46 broken sidebar links and expand
documentation coverage. Includes generation script for maintainable inventory
pages, full playbook summaries, learning lab tutorials, architecture docs,
contributing guides, and comprehensive reference material.
New pages: Getting Started (4), User Guides (5), Building Skills & Plugins (7),
Playbooks (12), Learning Lab (6), Architecture (4), Contributing (4),
Inventory (3), Reference (3). Updated: Home, Sidebar, Footer.
Stats: 52 sidebar links (0 broken), 352 internal cross-links, 8,270 total lines.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>