← AI DevKitCONTENT HISTORY

Update to AI DevKit

Snapshot Sep 30, 2026 · 23:15 UTC · version 0.62.1

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "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.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 319
    }
  ],
  "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"
}

SHA-256: d79db4c4777f4b1c8f109d46d87b914985d8c579c5a068f52e511903ada2ad89