Why

The existing switchyard-docs skill combines durable MkDocs policy with drafting, editing, and review concerns. Splitting those workflows makes skill selection more precise while keeping repository-specific documentation rules scoped to the documentation tree.

What

• Move Switchyard's MkDocs, publishing, accuracy, and CI rules into docs/AGENTS.md.
• Add dedicated skills for drafting, polishing, example auditing, novice review, and pragmatist review.
• Remove the superseded all-purpose switchyard-docs skill.
• Exclude docs/AGENTS.md from the published MkDocs site and document the new skill entry points in the root guidance.

How

The new skills adapt the corresponding NVIDIA Tech Docs workflows under Apache-2.0. Adaptations are limited to repository-local names, standalone operation without DORI/plugin-runtime dependencies, and loading the scoped documentation guidance. Generic evidence-source guidance remains generic.

Where to Start Review

Start with docs/AGENTS.md, then review the five .agents/skills/switchyard-docs-*/SKILL.md files and the discovery list in AGENTS.md.

Test Plan

• Five skill structural validations
• Frontmatter parsing and unique skill-name check across all repository skills
• Scan for stale switchyard-docs and DORI/plugin-runtime references
• git diff --check
• cd docs && make publish

All listed checks pass. The validation selector referenced by switchyard-testing-ci is absent on current main, so the documented direct gates were run instead.

Summary by CodeRabbit

• Documentation
  • Added documentation contribution guidelines covering authoring, review, validation, publishing, and security practices.
  • Added specialized workflows for drafting, polishing, auditing, and reviewing documentation.
  • Updated project guidance to reference the new documentation workflows.
  • Excluded internal contributor guidance from the published documentation site.
• Chores
  • Removed outdated documentation workflow instructions.