Technical Writer

Docs that follow Diataxis, not vibes.

AvailableProduct & Engineeringv1.0.10

About this persona

Audits documentation sets, maps information architecture by Diataxis type and audience, plans SME interviews, drafts tutorials, how-to guides, and API reference, and edits for style, terminology, and spec accuracy. Tool-agnostic: Markdown, Docusaurus, MkDocs, Sphinx, OpenAPI, Vale.

What it does

Doc-set audits: gaps, overlaps, staleness, mixed-type pages
Information architecture mapped by Diataxis type and audience
Tutorials, how-to guides, and API/config reference drafting
Style, terminology, and accuracy editing passes
Flags anything only a subject-matter expert can confirm

Commands and examples

Every capability below is a skill in the plugin. Run it directly with its namespaced slash command, or just describe what you want in plain language and the matching skill activates on its own, both work.

Get help and onboarding

Run this any time in Claude Code. It explains the persona and how to run any capability below.

/technical-writer:help-tw

Researching and architecting docs

Audits an existing doc set for gaps, overlaps, and staleness, turns a spec or PR into an SME interview plan, and maps information architecture by Diataxis type and audience.

Run it directly

/technical-writer:researching-and-architecting-docs

Or just describe what you want

Audit our docs for gaps and staleness and propose a table of contents by Diataxis type: [paste doc list or links].

Drafting content

Drafts documentation to the correct Diataxis type, learning-oriented tutorials, task-oriented how-to guides, and information-oriented API or config reference.

Run it directly

/technical-writer:drafting-content

Or just describe what you want

Write a how-to guide for configuring SSO from this spec: [paste spec].

Editing and quality control

Enforces style-guide voice and one-term-per-concept terminology, validates that documented steps match the spec or product, and reconciles contradictory pages.

Run it directly

/technical-writer:editing-and-quality-control

Or just describe what you want

Run an editorial QA pass on this page for style, terminology, and step accuracy: [paste page].

Install in Claude Code

/plugin marketplace add roleplugin/personas-marketplace

/plugin install technical-writer@personas-marketplace

Requires an active subscription. Prefer not to use GitHub? Download the zip from your library instead.

How to use it

Install the persona, then either ask Claude for the kind of work it covers in plain language, or run a capability directly as its namespaced slash command, /technical-writer:<skill-name>. Every RolePlugin persona also ships a built-in help guide, /technical-writer:help-tw, so you can run it any time to see what the persona can do and how to work with it.