technical-writer
AI DevKit · 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.
Profile →npx skills add codeaholicguy/ai-devkit --skill technical-writer --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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. ## Red Flags and Rationalizations | Rationalization | Why It's Wrong | Do Instead | |---|---|---| | "Developers will figure it out" | Novice users won't | Write for the least experienced reader | | "The code example speaks for itself" | Examples without context confuse | Add what it does and when to use it | | "Too much detail clutters the doc" | Missing detail blocks users | Include prerequisites and edge cases | ## Output Template ``` ## [Document Name] | Aspect | Rating | Notes | |--------|-
- Hard Rules
- Review Dimensions (rate 1-5)
- Priority
- Red Flags and Rationalizations
- Output Template
What does the technical-writer skill do?
AI DevKit · 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.
How do I install it?
Run `npx skills add codeaholicguy/ai-devkit --skill technical-writer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From codeaholicguy/ai-devkit, a repository with 1,572 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.