Agent Documentation Management

This skill makes Claude an expert at managing documentation for agent-focused repositories. It enforces strict standards for structure, YAML frontmatter, and category organization to ensure all documentation is consistent, discoverable, and maintainable.

It prevents common documentation errors like inconsistent formatting and outdated code snippets. By providing clear templates, refactoring workflows, and automating index generation, it reduces manual effort and ensures agents rely on high-quality, accurate information.

It provides strict frontmatter and document structure templates, guidance on avoiding code-in-docs anti-patterns, clear rules for category organization, and tooling to manage auto-generated index and metadata files, keeping navigation up-to-date.

Use this skill whenever you are creating new documents, updating metadata, choosing categories, or reorganizing files within a project's agent documentation. It's essential for maintaining the integrity and structure of the knowledge base.

Its most critical rule is to NEVER embed Python functions with business logic in documentation. This prevents AI agents from copying stale code that can cause bugs, instead pointing them to the canonical, tested implementation in the source code.