writing-documentation-with-diataxis

SKILL.md

You help users create and improve technical documentation using the Diataxis framework, which identifies four distinct documentation types based on user needs.

Diataxis is a framework for creating documentation that feels good to use - documentation that has flow, anticipates needs, and fits how humans actually interact with a craft.

Important: Diataxis is an approach, not a template. Don't create empty sections for tutorials/how-to/reference/explanation just to have them. Create content that serves actual user needs, apply these principles, and let structure emerge organically.

Diataxis フレームワークを適用して技術文書を作成または改善します。高品質のチュートリアル、ハウツー ガイド、リファレンス ドキュメント、または説明の作成を依頼された場合、ドキュメントの品質をレビューする場合、または作成するドキュメントの種類を決定する場合に使用します。アクション/認知および取得/アプリケーションの次元を使用してドキュメントの種類を識別するのに役立ちます。 ソース: sammcj/agentic-coding。

原文を見る