split agent-docs skills

skills/agent-docs-consistency/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: agent-docs-consistency
+description: Use when checking the AGENTS.md and agent-docs graph for reachability, cycles, depth, duplicate authority, routing clarity, or rule-doc versus inventory-doc consistency.
+---
+
+# Agent Docs Consistency
+
+## Overview
+
+Use this skill for structural consistency checks across AGENTS and `agent-docs`. It focuses on the document graph and authority model, not repository behavior.
+
+## When to Use
+
+- The user asks whether there are cycles
+- The user asks for document depth or routing structure
+- The user asks whether two docs both own the same rule
+- The user asks whether a doc has become a secondary router or mixed-shape document
+
+## Workflow
+
+1. Read the root `AGENTS.md`.
+2. Read the active child docs in scope.
+3. Read `../agent-docs/references/consistency-checklist.md`.
+4. Inspect:
+   - root reachability
+   - shortest routing depth
+   - direct cycles and high-noise cross-links
+   - duplicate authority candidates
+   - out-degree hotspots
+   - rule-doc vs inventory-doc shape mismatches
+5. Distinguish:
+   - blocking or high-noise structural problems
+   - acceptable cross-references
+6. Report the structural findings without drifting into repository implementation review. Use `agent-docs-repo-alignment` for repo-fact comparison.
+
+## Output
+
+- Reachability summary
+- Cycle summary
+- Duplicate-authority or shape findings
+- Residual risk assessment

skills/agent-docs-consistency/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Check agent-doc consistency"
+  short_description: "Check graph and authority consistency"
+  default_prompt: "Use $agent-docs-consistency to inspect the agent-doc graph for reachability, cycles, duplicate authority, and shape mismatches."