keithdv

Docs Why — Documentation skill for Claude Code

Documentation community

Interactive documentation improvement - ask the domain expert "why" questions, then write prose from their answers.

How to install Docs Why

Installs to ~/.claude/skills/keithdv-claudeskills-docs-why/SKILL.md

Terminal

mkdir -p ~/.claude/skills/keithdv-claudeskills-docs-why && curl -fsSL https://raw.githubusercontent.com/keithdv/ClaudeSkills/HEAD/commands/docs-why.md -o ~/.claude/skills/keithdv-claudeskills-docs-why/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Docs Why does

name: docs-why description: Interactive documentation improvement - ask the domain expert "why" questions, then write prose from their answers argument-hint: " - e.g., docs/factory-operations.md" allowed-tools: ["Glob", "Grep", "Read", "Edit", "Write", "AskUserQuestion"]

Improve documentation by extracting "why" knowledge from the domain expert (the user).

The Problem This Solves

AI-generated documentation tends to be technically accurate but missing the *why* — the desig

Alternatives in Documentation

Doc Co-authoring — Guide users through structured workflow for co-authoring documentation 94.1k ★
Question — Answer the user's question by analyzing the project structure and documentation 3.4k ★
Docs Serve — Build the HTML documentation and then serve it locally so it can be viewed in a browser 1.1k ★