format-documentation

Format Claude-facing documentation with 110-character wrapping and YAML multi-line syntax.

101|2|Updated Jan 7, 2026

Search Tags:#documentation #markdown #formatting #Claude #yaml #line-wrapping

Ready to run

npx skills add https://github.com/cowwoc/cat --skill format-documentation

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: format-documentation
Source: https://github.com/cowwoc/cat/tree/main/plugin/skills/format-documentation
Command: npx skills add https://github.com/cowwoc/cat --skill format-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps writers and engineers format Claude-facing documentation to enforce readable line lengths and correct YAML multi-line syntax, reducing manual reformatting and errors.

Core Features & Use Cases

Enforces a 110-character line limit for Claude-facing documentation
Applies YAML frontmatter multi-line styling using folded (>) and literal (|) operators
Preserves code blocks, URLs, and tables to maintain structure while wrapping prose where appropriate
Works on common Claude-facing docs such as CLAUDE.md, docs/project/ protocol docs, and human-facing README notes

Quick Start

Copy and apply the guidelines to your CLAUDE.md and related docs. Example tasks include wrapping prose with > for long lines, keeping code blocks intact, and leaving URLs and tables unwrapped.

Frequently Asked Questions about format-documentation

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

FAQPage Schema

How do I enforce line-length limits in CLAUDE.md documentation?▼

To enforce line-length limits in CLAUDE.md documentation, apply a 110-character wrapping rule to prose while preserving code blocks, URLs, and tables to maintain structural integrity.

What is the correct way to format YAML frontmatter multi-line syntax?▼

YAML frontmatter multi-line syntax is formatted using folded (>) operators for continuous prose and literal (|) operators for block text, ensuring readable line lengths without breaking YAML syntax.

How do I wrap markdown prose without breaking URLs and tables?▼

Wrapping markdown prose without breaking URLs and tables requires applying line-length limits only to text paragraphs, while explicitly leaving code blocks, URLs, and table structures unwrapped during the formatting process.

Does YAML folded style work for long documentation lines?▼

YAML folded style works for long documentation lines by using the greater-than (>) operator to wrap continuous prose into readable lengths while maintaining valid YAML multi-line syntax for Claude-facing docs.

When should I use literal vs folded YAML style in markdown documentation?▼

Use YAML literal style (|) for preserving block text and line breaks in markdown documentation, and use folded style (>) for wrapping continuous prose paragraphs to meet line-length requirements.