README Craft

For general technical writing patterns, see technical-writer skill.

Common Failures

• Installation first -> Lead with TL;DR and value prop
• Describes what it IS -> Describe what problem it SOLVES
• No examples -> One example per feature minimum
• Hidden limitations -> Dedicated limitations section
• Single install method -> Three+ pathways

Golden Structure

Tier 1: Hero Section