# Technical Writing

> Compose, edit, or review concise technical prose while preserving supported claims, terminology, certainty, conditions, causality, commands, identifiers, and values. Use directly for technical notes, comments, issues, explanations, and other small technical-writing tasks; use technical-docs or tech-blog for substantive workflows.

- Skill: `sandipb/technical-writing` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add sandipb/technical-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sandipb/technical-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sandipb (https://skillmd.com/u/sandipb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sandipb/technical-writing

---


# Technical writing

Use only authoritative context already present or explicitly supplied. Leave research, investigation, debugging, and
fact-checking to the main agent. Produce a supportable partial result and identify material gaps instead of inventing
facts, causes, requirements, risks, examples, or conclusions.

Apply these invariants in order:

1. Preserve supported technical meaning and requirement strength.
2. Preserve terminology, certainty, conditions, exceptions, causality, commands, identifiers, paths, values, and units.
3. Follow explicit user instructions, then project guidance, nearby conventions, existing structure, and minimal
   generic organization.
4. Improve precision, concision, ambiguity, and information density.

Apply grammar, punctuation, certain clarity improvements, terminology consistency, and removal of semantic duplication
inline. Return additions, removal of distinct information, examples, analogies, major restructuring, changed emphasis,
and ambiguous claims as author-judgment suggestions.

Remove unnecessary throat-clearing, generic introductions or conclusions, unsupported significance claims, repetitive
generic transitions, synonym cycling, immediate paraphrastic repetition, and empty generic sections. Retain useful
repetition and predictable structure. Optimize for clear technical prose, not detector evasion or artificial
humanization.

For documentation, use `technical-docs`. For reader-oriented technical articles, use `tech-blog`.