Back to skills
SkillHub ClubWrite Technical DocsTech Writer

writing-documentation-with-diataxis

Applies the Diataxis framework to structure technical documentation into four distinct types based on user intent: tutorials, how-to guides, reference, and explanation. Provides a clear decision compass and specific writing principles for each type, helping writers avoid common pitfalls like mixing learning and working content.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
110
Hot score
94
Updated
March 20, 2026
Overall rating
A8.3
Composite score
5.8
Best-practice grade
A88.4

Install command

npx @skill-hub/cli install sammcj-agentic-coding-diataxis-documentation
technical-writingdocumentation-frameworkcontent-strategy

Repository

sammcj/agentic-coding

Skill path: Claude/skills/diataxis-documentation

Applies the Diataxis framework to structure technical documentation into four distinct types based on user intent: tutorials, how-to guides, reference, and explanation. Provides a clear decision compass and specific writing principles for each type, helping writers avoid common pitfalls like mixing learning and working content.

Open repository

Best for

Primary workflow: Write Technical Docs.

Technical facets: Tech Writer.

Target audience: Documentation teams looking for install-ready agent workflows..

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: sammcj.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install writing-documentation-with-diataxis into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/sammcj/agentic-coding before adding writing-documentation-with-diataxis to shared team environments
  • Use writing-documentation-with-diataxis for documentation workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

writing-documentation-with-diataxis | SkillHub