Writing Documentation With Diataxis

This helps Claude write technical documentation using the Diataxis framework, which organizes docs into four types based on what users actually need: tutorials for learning by doing, how-to guides for accomplishing specific tasks, reference material for looking up facts, and explanations for understanding concepts. The approach is refreshingly anti-template. Instead of forcing you to fill out all four sections, it encourages creating what serves real user needs and letting structure emerge naturally. Built by sammcj with 136 stars and 475 installs. If you've ever stared at a blank docs page wondering whether to write a tutorial or a guide, this gives you a practical mental model for deciding what to create and how to structure it.

Install to Claude Code

npx -y skills add sammcj/agentic-coding --skill writing-documentation-with-diataxis --agent claude-code