doc-management

Enforce YAML frontmatter and structured sections for project documents.

3|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/doancan/mags --skill doc-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-management
Source: https://github.com/doancan/mags/tree/main/skills/doc-management
Command: npx skills add https://github.com/doancan/mags --skill doc-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document teams often struggle to keep consistent formatting, lifecycle management, and discoverability across project docs. This skill enforces standardized frontmatter, structured sections, and cross-referencing to reduce drift and confusion.

Core Features & Use Cases

  • YAML frontmatter rules: enforce required fields like title, description, status, created, updated, author, and tags.
  • Section structure guidance: prescribe H1/H2/H3 layout for guides, references, and ADRs to improve readability and navigation.
  • Lifecycle governance: support for DRAFT, REVIEW, and LOCKED statuses to prevent unapproved changes.

Quick Start

Create your first document in your docs/ folder following the frontmatter and heading structure and update the created/updated fields accordingly.

Frequently Asked Questions about doc-management

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

FAQPage Schema
How do I enforce consistent frontmatter across project documentation?

Enforce consistent frontmatter by applying standardized YAML rules with required fields like title, description, status, created, updated, author, and tags. This ensures uniform metadata across all project docs, reducing drift and confusion among team members.

What is the best way to manage document lifecycle states for technical guides?

Manage document lifecycle states by using DRAFT, REVIEW, and LOCKED statuses within your markdown frontmatter. This governance approach prevents unapproved changes to technical guides, reference docs, and ADRs until they pass formal review.

How do I structure markdown headings for ADRs and reference docs?

Structure markdown headings by prescribing a strict H1/H2/H3 layout for ADRs, reference docs, and guides. This section structure guidance improves readability and navigation across software project documentation, ensuring cross-references remain logically organized.

Do I need any specific dependencies to standardize markdown formatting for my team?

No specific dependencies are required to standardize markdown formatting. The governance rules apply natively to your docs/ folder by enforcing YAML frontmatter standards and structured sections without external components or libraries.

Can I use document lifecycle governance for changelogs and software project docs?

Yes, you can apply document lifecycle governance to changelogs, writing guides, reference docs, and ADRs within software projects. The standardized frontmatter and lifecycle statuses ensure consistent formatting and discoverability across all project documentation types.

Why does inconsistent frontmatter cause documentation drift in software projects?

Inconsistent frontmatter causes documentation drift because missing or varied metadata fields prevent automated tracking and cross-referencing. Enforcing required YAML fields like status, updated, and author standardizes discoverability and formatting across teams.