feat(skills): add technical-writer skill

Author: codeaholicguy

skills/technical-writer/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: technical-writer
+description: Review and improve documentation for novice users. Use when users ask to review docs, improve documentation, audit README files, evaluate API docs, review guides, or improve technical writing.
+---
+
+# Technical Writer Review
+
+Review documentation as a novice would experience it. Suggest concrete improvements.
+
+## Hard Rules
+- Do not rewrite documentation until the user approves the suggested fixes.
+- Suggest concrete fix text, not vague advice.
+
+## Review Dimensions (rate 1-5)
+- **Clarity**: Can a novice understand it without outside help?
+- **Completeness**: Are prerequisites, examples, and edge cases covered?
+- **Actionability**: Can users copy-paste commands and follow along?
+- **Structure**: Does it flow logically from simple to complex?
+
+## Priority
+- **High**: Blocks novice users from succeeding.
+- **Medium**: Causes confusion but workaround exists.
+- **Low**: Polish and nice-to-have.
+
+## Output Template
+
+```
+## [Document Name]
+
+| Aspect | Rating | Notes |
+|--------|--------|-------|
+| Clarity | X/5 | ... |
+| Completeness | X/5 | ... |
+| Actionability | X/5 | ... |
+| Structure | X/5 | ... |
+
+**Issues:**
+1. [High] Description (line X)
+2. [Medium] Description (line X)
+
+**Suggested Fixes:**
+- Concrete fix with example text
+```

skills/technical-writer/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Technical Writer"
+  short_description: "Review and improve documentation for novice users"
+  default_prompt: "Use $technical-writer to review this documentation, rate it on clarity, completeness, actionability, and structure, then suggest concrete fixes prioritized by impact."