← All skills

writing-documentation-with-diataxis

85 / 100 · Low risk

Fine to try.

By sammcj/agentic-coding (GitHub) · writing · 171 stars · scanned at commit 09c80d3

Applies the Diataxis framework to create or improve technical documentation. Use when being asked to write high quality tutorials, how-to guides, reference docs, or explanations, when reviewing documentation quality, or when deciding what type of documentation to create. Helps identify documentation types using the action/cognition and acquisition/application dimensions.

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'writing-documentation-with-diataxis' ] || [ -L ~/.agents/skills/'writing-documentation-with-diataxis' ]; then echo 'A skill folder named writing-documentation-with-diataxis already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/sammcj/agentic-coding' "$d" && git -C "$d" checkout --quiet '09c80d352bc3a099bf654f433edffdb30af021a7' -- 'Skills_disabled/diataxis-documentation' && mkdir -p ~/.agents/skills && cp -R "$d"/'Skills_disabled/diataxis-documentation' ~/.agents/skills/'writing-documentation-with-diataxis' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'writing-documentation-with-diataxis' ~/.claude/skills/'writing-documentation-with-diataxis' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for sammcj/agentic-coding shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/sammcj/agentic-coding.svg)](https://zalavijaysinh.github.io/skilltrust/repos/sammcj/agentic-coding/)

Score history