documentation

Enforce YAML frontmatter and structure for README.md and CLAUDE.md.

5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/agentxm/axm --skill documentation-agentxm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation
Source: https://github.com/agentxm/axm/tree/main/.claude/skills/documentation
Command: npx skills add https://github.com/agentxm/axm --skill documentation-agentxm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation teams often produce inconsistent README and agent instructions. This Skill defines a standardized approach to documentation across human-facing and agent-facing contexts.

Core Features & Use Cases

  • Template conformance: Enforces frontmatter and structure for README.md and CLAUDE.md.
  • Guided content structure: Provides recommended sections and flows for human-facing and agent-facing docs.
  • Quality checks: Includes anti-pattern guidance and references cross-links to canonical specs.

Quick Start

Create or update both README.md and CLAUDE.md in your project following these conventions.

Frequently Asked Questions about documentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize README and agent instruction documentation across my project?

To standardize README and agent instruction documentation, apply consistent frontmatter and structure templates to README.md and CLAUDE.md files, eliminating duplication and ensuring consistent human-facing and agent-facing content flow.

What is the best way to maintain consistency between human-facing docs and agent instructions?

Maintaining consistency between human-facing docs and agent instructions requires enforcing a standardized style-guide that defines required YAML frontmatter, recommended document structure, and cross-links to canonical specs for both contexts.

Does my project need YAML frontmatter in CLAUDE.md files?

Your project needs YAML frontmatter in CLAUDE.md files if you want to enforce template conformance and standardize agent-facing instruction guides, as it specifies required metadata for consistent documentation practices.

How do I avoid content duplication when writing README and CLAUDE files?

Avoid content duplication in README and CLAUDE files by following a guided content structure that provides recommended sections and flows, alongside anti-pattern guidance and cross-links to canonical specs to prevent redundant explanations.

What structure should I use for agent-facing instruction guides?

Agent-facing instruction guides should use a standardized structure that specifies required YAML frontmatter, recommended document flow, and guidance to avoid unnecessary explanations, ensuring agents receive clear and consistent instructions.

When should I not use a standardized documentation template for my project?

You should not use a standardized documentation template if your project does not maintain both human-facing documentation and agent-facing instruction guides, as the conformance rules specifically target README.md and CLAUDE.md files.