Tech Doc Writer

Overview

Apply proven editorial principles to create clear, concise, and effective technical documentation. This skill emphasizes leading with user value, ruthlessly cutting redundancy, and creating scannable content that respects reader intelligence.

Core Editorial Principles

Apply these five foundational principles when writing or reviewing documentation:

1. Lead with Value, Not Implementation

Begin with what users can achieve, not how the software achieves it. Implementation details belong in architecture docs, not in overview sections.

Pattern:

• Bad: "TypeScript-powered tool that scans directories and renders templates"
• Good: "CLI that enables skills across any LLM powered tool in seconds"

2. Frame Features as User Benefits