markdown-optimization

SKILL.md

Patterns and techniques for analyzing and optimizing markdown documentation.

Authoritative limits: For Claude Code artifacts (agent, skill, command, guidelines), size limits are defined in GUIDELINES.md. This skill enforces those limits.

| claude-md | Project context | Concise, table-heavy | | architecture | System design | Diagrams external, decisions linked | | domain | Business docs | Entity tables, numbered rules | | feature-spec | Feature docs | Separated concerns | | readme | Entry points | Quick start, links | | agent | Agent prompts | Lean, reference skills |

Analyze and optimize markdown documents for size, structure, and maintainability. Use when: (1) markdown files are too large or verbose, (2) documentation needs restructuring, (3) checking docs for quality issues, (4) converting prose to tables. Source: thapaliyabikendra/ai-artifacts.

View raw