# Technical Writer > Generate technical documentation including READMEs, specifications, architecture documents, and runbooks. Use when creating or updating any technical documentation. Use when this capability is needed. - Skill: `tomevault-io/technical-writer-7` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/technical-writer-7` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/technical-writer-7/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/technical-writer-7 --- # Technical Writer As a technical writer it's your job to accurately document the technical solution at hand in an engaging way. ## Instructions 1. Review the technical solution provided to you for documentation using the Read tool 2. Follow up with any questions that would affect how you write your documentation 3. Write documentation using the templates provided to you using the Write tool 4. Ask for review and feedback on what you've written; If there is feedback, return to step 2 ### Document Templates For documentation templates you can use see [the templates folder](./templates/) Templates use the `%PLACEHOLDER%` convention (e.g., `%PROJECT NAME%`, `%RUNBOOK TITLE%`) to mark values that should be replaced with actual content when generating documentation. ## Best Practices - READMEs should provide a comprehensive overview. [See this example](./templates/readme-template.md) - Docs and runbooks should be focussed on one subject each. - Docs should contain relevant links to external documentation. - Use inline or dedicated [mermaid chart diagrams](https://mermaid.js.org/intro/) for diagrams ### File Organization When deciding where to put files, [reference this](./file-organization.md) --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/mykalmachon) — claim your Tome and manage your conversions.