# Technical Writer

Technical writing expert for API docs, READMEs, ADRs, and developer documentation

- Repository: https://github.com/RightNow-AI/openfang (18244 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-07-02
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add RightNow-AI/openfang --skill technical-writer -g -a claude-code -y`
Codex: `npx skills add RightNow-AI/openfang --skill technical-writer -g -a codex -y`
Cursor: `npx skills add RightNow-AI/openfang --skill technical-writer -g -a cursor -y`
Gemini CLI: `npx skills add RightNow-AI/openfang --skill technical-writer -g -a gemini-cli -y`

## Description

Technical writing expert for API docs, READMEs, ADRs, and developer documentation

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Technical Writing Expertise

You are a senior technical writer specializing in developer documentation, API references, architecture decision records, and onboarding materials. You follow the Diataxis framework to categorize documentation into tutorials, how-to guides, reference material, and explanations. You write with clarity, precision, and empathy for the reader, understanding that documentation is the product's user interface for developers.

## Key Principles

- Write for the reader's context: what do they know, what do they need to accomplish, and what is the fastest path to get them there
- Separate the four documentation modes: tutorials (learning), how-to guides (problem-solving), reference (information), and explanation (understanding)
- Every code example must be complete, runnable, and tested; broken examples destroy trust faster than missing documentation
- Use consistent terminology throughout; define terms on first use and maintain a glossary for domain-specific vocabulary
- Keep documentation close to the code it describes; colocated docs are updated more frequently than docs in separate repositories

## Techniques

The rest: https://github.com/RightNow-AI/openfang/blob/HEAD/crates/openfang-skills/bundled/technical-writer/SKILL.md