readme-writer 是一个开源项目的 README 写作技能，用于撰写、改进或评审 README。其经验来自对 GitHub 上 20 个成功开源仓库的分析，覆盖工具类（如 ripgrep、bat、fzf、GitHub CLI、Caddy、Traefik、Meilisearch）、AI/ML 类（如 Ollama、llama.cpp、AutoGPT、Stable Diffusion Web UI、Transformers、AutoGen、openpilot）以及代码框架类（如 Express、FastAPI、Gin、NestJS、Laravel、SQLModel）。
主要能力：先判断项目类型（工具/软件、AI/ML、代码框架），收集或推断项目名称、用途、技术栈与目标读者，再套用通用结构撰写完整 Markdown README；若用户直接粘贴现有 README 求反馈，则对照这些模式给出改进建议。
通用 README 结构：Logo/主图、一句话标语、徽章、描述（2-4 句）、演示/截图/GIF、核心特性、安装、快速开始/用法、文档链接、贡献指南、许可证。各部分并非必须，权重随项目类型变化，可阅读对应参考文件。
通用最佳实践：Logo 居中、支持深/浅色模式、高度约 300px 以内；标语一句话、15 词以内并突出价值或差异；徽章用 shields.io，建议 3-6 个，最多不超过 8 个；描述回答“是什么、解决什么问题、给谁用”；演示优先用无缝循环、小于 5MB 的 GIF，其次截图，或代码与输出对照；核心特性用要点列表，每条一行、聚焦用户收益；安装先给最简单的命令，再给 Docker、源码构建等替代方案；用法先给最小可用示例；始终提供完整文档链接、最小贡献说明和明确的许可证声明。
使用方式：先询问“项目类型是什么（工具/AI-ML/框架）”和“目标读者是谁”，阅读对应参考文件，按通用结构加类型模式起草，再用检查清单自检（标语是否 15 词内传达价值、是否有视觉元素、新用户能否 5 分钟内安装运行、是否有至少 2-3 个可复制示例、是否有文档链接、许可证是否清晰），最后交给用户反馈。
限制：资料未提供该技能的具体安装命令、收费与价格、支持平台和详细使用步骤。