| Skill workflow | End-to-end integration playbook | .agents/skills/tool-ui/SKILL.md |
| Component metadata (canonical) | Source of truth for shipped docs components | lib/docs/component-registry.ts |
| Component metadata (agent-optimized) | Fast lookup for scripts and intent matching | .agents/skills/tool-ui/references/components-data.json |
| Catalog and bundles | Human-readable component discovery and intent bundles | .agents/skills/tool-ui/references/components-catalog.md, .agents/skills/tool-ui/references/recipes.md |
| Integration recipes | Runtime wiring patterns by integration mode | .agents/skills/tool-ui/references/integration-patterns.md |
| Troubleshooting matrix | Symptom → likely cause → fix | .agents/skills/tool-ui/references/troubleshooting.md |
| Component sync script | Regenerates agent metadata from canonical source | .agents/skills/tool-ui/scripts/sync_components.py |
| Compatibility doctor | Detects and explains integration blockers | .agents/skills/tool-ui/scripts/tool_ui_compat.py |
| Install/discovery helper | Lists, finds, bundles, and prints install commands | .agents/skills/tool-ui/scripts/tool_ui_components.py |
| Scaffold generator | Generates ready-to-paste runtime wiring snippets | .agents/skills/tool-ui/scripts/tool_ui_scaffold.py |
| Script test suite | Regression coverage for agent-facing tooling | .agents/skills/tool-ui/tests/ |
| Docs contract tests | Guards docs consistency and registry-installation policy | lib/tests/tool-ui/docs/ |