{"id":19394,"plugin_id":"plugins_6a97f99a25c08191a853f2805bcc6efb","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:15:32.548Z","digest":"d79db4c4777f4b1c8f109d46d87b914985d8c579c5a068f52e511903ada2ad89","against":null,"payload":{"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.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":319}],"name":"technical-writer","skill_md_contents":"---\nname: technical-writer\ndescription: 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.\n---\n\n# 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```\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}