mcpbeat

Technical Writer

onewave-ai/technical-writer

Write comprehensive technical documentation including user guides, how-to articles, system architecture docs, onboarding materials, and knowledge base articles. Creates clear, structured documentation for technical and non-technical audiences. Use when users need technical writing, documentation, tutorials, or knowledge base content.

2k tokens
context cost
the whole folder, loaded on every use
5
files
instructions only
0
copies elsewhere
how many repositories repackaged it
235
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/OneWave-AI/claude-skills --skill technical-writer

The instruction itself

4 sections, as written by the author

Technical Writer

Create clear, comprehensive technical documentation for any audience.

Contents

  • references/templates.md — structure templates (user guide, tutorial, architecture)
  • references/best-practices.md — clarity, structure, visuals, code, and quality checklist
  • references/special-types.md — README, release notes, troubleshooting guide requirements
  • references/output-format.md — final delivery wrapper and maintenance notes

Workflow

  • Identify the documentation type. See references/special-types.md for the full type list and type-specific section requirements.
  • Determine the audience:
  • Technical level (beginner, intermediate, expert)
  • Role (end user, developer, admin, stakeholder)
  • Prior knowledge assumptions
  • Context (internal team, external customers, open source community)
  • Select and fill the matching structure template from references/templates.md. Start simple, then layer in complexity.
  • Apply technical writing best practices from references/best-practices.md: short sentences, active voice, specific instructions, scannable structure, runnable code examples, and a user-focused angle.
  • Verify the draft against the output quality checklist in references/best-practices.md.
  • Deliver using the wrapper in references/output-format.md, including the documentation checklist and maintenance notes.

Example Triggers

  • "Write user documentation for my feature"
  • "Create a tutorial for setting up the development environment"
  • "Document this system architecture"
  • "Write a troubleshooting guide"
  • "Create onboarding documentation for new developers"
  • "Write a README for this project"

Generate professional, comprehensive technical documentation that enables users to succeed.

How to use it

Copy the folder

Take onewave-ai/technical-writer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.