documentation-writing

SKILL.md

Creates high-quality, discoverable documentation following the Eight Rules and Diataxis framework. Ensures all docs are properly located, linked, and contain real runnable examples.

| Type | Purpose | Location | User Question |

| Tutorial | Learning | docs/tutorials/ | "Teach me how" | | How-To | Doing | docs/howto/ | "Help me do X" | | Reference | Information | docs/reference/ | "What are the options?" | | Explanation | Understanding | docs/concepts/ | "Why is it this way?" |

遵循八項規則和 Diataxis 框架編寫清晰、可發現的軟件文檔。在創建自述文件、API 文檔、教程、操作指南或任何項目文檔時使用。自動強制執行文檔/位置、鏈接要求和可運行示例。 來源：nilecui/skillsbase。

查看原文