skills.rest
cowwoc
cowwocCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/cowwoc/cat --skill format-documentation
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
quarcs-labquarcs-lab

one-sentence-per-line

Reformat index.qmd to place each sentence on its own line.

Official
Intermediate
podcodarpodcodar
7

markdown-format

Format and validate Markdown files for consistent headings, lists, and YAML frontmatter.

Official
Intermediate
lbliiilbliii
41

bengal-content-migration

Migrates static site and Markdown content to Bengal format.

Community
Intermediate
pingcappingcap
5

writing-doc-summaries

Generate compliant YAML front matter summaries for Markdown documents.

Official
Intermediate