Technical Document Writing

Use for technical plans, architecture, implementation plans, API or database documentation, runbooks, incident reports, review reports, management reports, and README work.

JimmyVGDY Updated

File contents

Technical Documentation

  1. Establish audience, purpose, decision, scope, evidence sources, output format, and modification authority.
  2. Separate confirmed facts, external material, engineering inference, assumptions, and unverified states.
  3. Select and trim the closest template. Avoid imposing a large structure on a small document.
  4. Route technical conclusions through the relevant domain Skill; this Skill structures and clarifies the result.
  5. When documentation is tied to code, tests, CHANGELOG, commit, or release, combine engineering delivery.
  6. Check accuracy, completeness, consistency, executability, maintainability, security, and readability.

Do not invent versions, validation, performance, estimates, budget, production state, or generated artifacts. Documentation work does not grant code, configuration, database, Git, or environment modification authority.

JimmyVGDY/codex-long-term-assistant-skills/tree/main/locales/en/skills/technical-document-writing commit fff34f8fe7

Frequently asked questions

npx skillmds@latest add jimmyvgdy/technical-document-writing-2