{"id":"34b62330-ff46-433b-ae7e-3a83c21c0f1d","shortId":"BMhW2E","kind":"skill","title":"technical-writer","tagline":"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.","description":"# Technical Writer Review\n\nReview documentation as a novice would experience it. Suggest concrete improvements.\n\n## Hard Rules\n- Do not rewrite documentation until the user approves the suggested fixes.\n- Suggest concrete fix text, not vague advice.\n\n## Review Dimensions (rate 1-5)\n- **Clarity**: Can a novice understand it without outside help?\n- **Completeness**: Are prerequisites, examples, and edge cases covered?\n- **Actionability**: Can users copy-paste commands and follow along?\n- **Structure**: Does it flow logically from simple to complex?\n\n## Priority\n- **High**: Blocks novice users from succeeding.\n- **Medium**: Causes confusion but workaround exists.\n- **Low**: Polish and nice-to-have.\n\n## Red Flags and Rationalizations\n\n| Rationalization | Why It's Wrong | Do Instead |\n|---|---|---|\n| \"Developers will figure it out\" | Novice users won't | Write for the least experienced reader |\n| \"The code example speaks for itself\" | Examples without context confuse | Add what it does and when to use it |\n| \"Too much detail clutters the doc\" | Missing detail blocks users | Include prerequisites and edge cases |\n\n## Output Template\n\n```\n## [Document Name]\n\n| Aspect | Rating | Notes |\n|--------|--------|-------|\n| Clarity | X/5 | ... |\n| Completeness | X/5 | ... |\n| Actionability | X/5 | ... |\n| Structure | X/5 | ... |\n\n**Issues:**\n1. [High] Description (line X)\n2. [Medium] Description (line X)\n\n**Suggested Fixes:**\n- Concrete fix with example text\n```","tags":["technical","writer","devkit","codeaholicguy","agent-skills","ai-assisted-development","antigravity","claude-code","codex","cursor","development","engineering"],"capabilities":["skill","source-codeaholicguy","skill-technical-writer","topic-agent-skills","topic-ai-assisted-development","topic-antigravity","topic-claude-code","topic-codex","topic-cursor","topic-development","topic-engineering","topic-engineering-enablement","topic-engineering-experience","topic-prd"],"categories":["ai-devkit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/codeaholicguy/ai-devkit/technical-writer","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add codeaholicguy/ai-devkit","source_repo":"https://github.com/codeaholicguy/ai-devkit","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1196 github stars · SKILL.md body (1,470 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:09.646Z","embedding":null,"createdAt":"2026-04-18T21:55:33.327Z","updatedAt":"2026-05-18T18:53:09.646Z","lastSeenAt":"2026-05-18T18:53:09.646Z","tsv":"'-5':72 '1':71,205 '2':210 'action':90,200 'add':165 'advic':67 'ai':4 'along':99 'api':26 'approv':57 'ask':16 'aspect':193 'audit':22 'block':111,182 'case':88,188 'caus':117 'clariti':73,196 'clutter':177 'code':156 'command':96 'complet':82,198 'complex':108 'concret':46,62,217 'confus':118,164 'context':163 'copi':94 'copy-past':93 'cover':89 'descript':207,212 'detail':176,181 'develop':140 'devkit':5 'dimens':69 'doc':19,27,179 'document':9,21,38,53,191 'edg':87,187 'evalu':25 'exampl':85,157,161,220 'exist':121 'experi':43 'experienc':153 'figur':142 'file':24 'fix':60,63,216,218 'flag':130 'flow':103 'follow':98 'guid':29 'hard':48 'help':81 'high':110,206 'improv':8,20,31,47 'includ':184 'instead':139 'issu':204 'least':152 'line':208,213 'logic':104 'low':122 'medium':116,211 'miss':180 'much':175 'name':192 'nice':126 'nice-to-hav':125 'note':195 'novic':11,41,76,112,145 'output':189 'outsid':80 'past':95 'polish':123 'prerequisit':84,185 'prioriti':109 'rate':70,194 'ration':132,133 'reader':154 'readm':23 'red':129 'review':6,18,28,36,37,68 'rewrit':52 'rule':49 'simpl':106 'skill' 'skill-technical-writer' 'source-codeaholicguy' 'speak':158 'structur':100,202 'succeed':115 'suggest':45,59,61,215 'technic':2,32,34 'technical-writ':1 'templat':190 'text':64,221 'topic-agent-skills' 'topic-ai-assisted-development' 'topic-antigravity' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-development' 'topic-engineering' 'topic-engineering-enablement' 'topic-engineering-experience' 'topic-prd' 'understand':77 'use':13,172 'user':12,15,56,92,113,146,183 'vagu':66 'without':79,162 'won':147 'workaround':120 'would':42 'write':33,149 'writer':3,35 'wrong':137 'x':209,214 'x/5':197,199,201,203","prices":[{"id":"68b3a176-46db-4d49-a7e3-7d3206c84887","listingId":"34b62330-ff46-433b-ae7e-3a83c21c0f1d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"codeaholicguy","category":"ai-devkit","install_from":"skills.sh"},"createdAt":"2026-04-18T21:55:33.327Z"}],"sources":[{"listingId":"34b62330-ff46-433b-ae7e-3a83c21c0f1d","source":"github","sourceId":"codeaholicguy/ai-devkit/technical-writer","sourceUrl":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/technical-writer","isPrimary":false,"firstSeenAt":"2026-04-18T21:55:33.327Z","lastSeenAt":"2026-05-18T18:53:09.646Z"}],"details":{"listingId":"34b62330-ff46-433b-ae7e-3a83c21c0f1d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"codeaholicguy","slug":"technical-writer","github":{"repo":"codeaholicguy/ai-devkit","stars":1196,"topics":["agent-skills","ai","ai-assisted-development","antigravity","claude-code","codex","cursor","development","engineering","engineering-enablement","engineering-experience","prd"],"license":null,"html_url":"https://github.com/codeaholicguy/ai-devkit","pushed_at":"2026-05-17T00:23:12Z","description":"A universal CLI toolkit for AI agent skills, enabling structured AI-assisted development across tools like Cursor, Claude Code, Codex, and more.","skill_md_sha":"7df8e2d4462a7b5fe1c2c9263f0af375a31e0697","skill_md_path":"skills/technical-writer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/technical-writer"},"layout":"multi","source":"github","category":"ai-devkit","frontmatter":{"name":"technical-writer","description":"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."},"skills_sh_url":"https://skills.sh/codeaholicguy/ai-devkit/technical-writer"},"updatedAt":"2026-05-18T18:53:09.646Z"}}