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.