{"id":"2274575e-0cd6-4efb-a539-96c8b86ac881","shortId":"gfVnQL","kind":"skill","title":"readme-generator","tagline":"为 GitHub 项目生成符合最佳实践的专业 README.md，包含 SEO/GEO 优化标题、16:9 信息图三件套（banner/features/workflow）、结构化作者信息、MIT 许可证、GitHub description 和 Topics 推荐。当用户说「帮我写 README」「生成 README」「README 最佳实践」「README 信息图」「GitHub 项目首页」「readme maker」「readme 生成」「写一个专业的 README」「项目文档」「开源说明」时必须使用此 skill。也适用于 README 已存在但","description":"# GitHub README Maker\n\n> 零 ASCII 艺术 · 零 Emoji 堆砌 · 排版驱动设计 · 信息图精准插入\n\n从第一性原理出发：README 是项目的门面，是 Google 和 AI 搜索的入口，是开发者决定是否 star/fork 的第一印象。一个好的 README 需要在 15 秒内传达三件事：**这是什么、能解决什么问题、怎么用**。\n\n---\n\n## 设计哲学\n\n**反模式（绝对避免）：**\n- ❌ 用 ASCII 艺术字幕开头（`╔══╗ ◇ Project ◇ ╚══╝`）\n- ❌ 第一行就是图片（SEO 不友好，爬虫读不到）\n- ❌ Emoji 装饰标题（`## 🚀 功能`——降低专业度）\n- ❌ 大段文字没有信息图辅助（阅读疲劳）\n- ❌ 缺少 GitHub Topics 和 Description（SEO 失分）\n\n**正确模式：**\n- `# 项目名` H1 + blockquote 标语 → 立即建立认知\n- Badge 行 → 信息密度高，一眼扫描状态\n- 16:9 Banner 信息图 → 视觉冲击，替代 ASCII\n- Features 信息图 + Workflow 信息图 → 核心价值可视化\n- 结构化作者区块 → 表格形式，统一风格\n\n**零 Emoji 原则（README 及信息图均适用）：**\n\n- README 中不用 emoji 装饰标题或作者表格（`:octocat:` `:globe_with_meridians:` 等 shortcode 同样禁止）\n- 信息图 HTML 中不用 emoji 作为图标——改用编号（`01` `02`）、SVG 图形或几何色块\n- 检查点提示文字中不用 ✅ 📋 ⚙️ 等符号，改用纯文字说明\n\n---\n\n## 总体流程\n\n```\nPhase 0    环境检查 (Node.js + Playwright)\nPhase 0.5  模式识别 (新建 vs 升级)\nPhase 1    项目信息采集 (6 个关键字段)\nPhase 1.5  设计风格选择 (npx getdesign list → 提取 Token，默认 claude)\nPhase 2    信息图生成 (3 张 HTML → PNG，应用风格 Token)\nPhase 3    README 组装 (8 个标准区块)\nPhase 4    GitHub 元信息建议 (description + topics)\nPhase 5    Git 提交 (可选，用户确认后)\n```\n\n---\n\n## Phase 0: 环境检查\n\n在开始前验证：\n\n```bash\nnode --version   # 要求 >= 18\n```\n\n检查 package.json：\n```bash\nls package.json 2>/dev/null || npm init -y\n```\n\n检查 Playwright：\n```bash\nnode -e \"require('playwright')\" 2>/dev/null && echo \"OK\" || (npm install playwright && npx playwright install chromium)\n```\n\n> **为什么需要 Playwright？** 信息图以 HTML 方式编写后通过 Playwright 截图为 PNG，这是在没有设计工具的情况下生成高质量信息图的最佳实践。详见 `scripts/gen_infographic.mjs`。\n\n---\n\n## Phase 0.5: 模式识别\n\n在采集信息前，先判断这是哪种场景——**新建**还是**升级**，后续流程会有所不同。\n\n### 判断规则\n\n| 场景 | 判断条件 | 进入流程 |\n|------|----------|----------|\n| **全新创建** | 用户没有提到现有文件，或目录内无 README.md | Phase 1 → 2 → 3 → 4 → 5（完整流程） |\n| **升级现有** | 用户说「我已有 README」「帮我优化/重构」，或当前目录存在 README.md | 先读取现有文件，再执行 **Phase 1 → 2 → 3（差量更新）→ 4 → 5** |\n\n### 升级现有 README 的差量策略\n\n当识别为「升级」场景时：\n\n1. **读取现有 README**，提取已有内容（项目名、描述、安装方式等）\n2. **诊断缺失项**，重点检查：\n   - 是否缺少 Banner/Features/Workflow 信息图？→ Phase 2 补充生成\n   - H1 标题是否以 ASCII 艺术或图片开头？→ Phase 3 重构开头\n   - 是否缺少作者区块？→ Phase 3 补充\n   - 是否缺少 GitHub 元信息建议？→ Phase 4 补充\n3. **保留用户已有的独特内容**（如详细的 API 文档、贡献指南），不要因为升级而删除\n\n> 升级时告诉用户：「我已读取你的现有 README，会保留原有内容并补充/重构以下部分：[列出差异]」，等用户确认后再继续。\n\n### Fallback 场景\n\n| 异常情况 | 处理方式 |\n|----------|----------|\n| 用户没有 Git 环境 | Phase 5 跳过，提醒用户手动复制文件 |\n| 作者信息完全缺失 | Phase 3 使用占位符 `[your-homepage]`，在 README 末尾注释提醒用户填写 |\n| Playwright 截图失败 | 检查 Chromium 路径 → 尝试 `npx playwright install chromium` → 仍失败则跳过信息图，Phase 3 保留 `![Banner](assets/banner.png)` 占位（后续可手动替换） |\n| 用户只想要文字版（无信息图） | 跳过 Phase 2，Phase 3 中信息图位置改为简洁的功能列表 |\n\n---\n\n## Phase 1: 项目信息采集\n\n向用户询问（或从上下文推断）以下 6 个字段：\n\n| 字段 | 示例 | 说明 |\n|------|------|------|\n| `project_name` | `Travel Guidebook` | 项目名，首字母大写 |\n| `tagline` | `从调研到成书的一站式旅行路书引擎` | 一句话价值主张，≤ 30 字 |\n| `problem` | `用 AI 自动生成精排旅行 PDF，替代手动整理攻略` | 解决什么问题 |\n| `features` | `并行调研 / 高德地图 MCP / Playwright PDF 导出` | 核心功能，3-6 条 |\n| `tech_stack` | `Node.js / Playwright / Claude Code` | 主要技术栈 |\n| `author` | 见下方作者结构 | 个人主页/GitHub/Twitter/公众号 |\n\n**作者信息结构：**\n```\nauthor:\n  homepage: https://example.dev\n  github: username\n  twitter: @handle\n  wechat: 公众号名称（可选）\n```\n\n如果用户已在上下文中提供了这些信息，无需重复询问，直接推断并确认。\n\n---\n\n## Phase 1.5: 设计风格选择\n\n> 使用 `getdesign` 工具从 60+ 大厂设计规范中选择风格，生成的信息图将自动应用对应的色彩和排版系统。\n\n### Step 1：列出可用风格\n\n```bash\nnpx getdesign list\n```\n\n> **如果 `npx getdesign list` 执行失败**（命令不存在、网络超时、npm registry 不可达）：跳过 Step 1-3，直接使用下方「claude 风格默认 Token」进入 Step 4。告知用户：「getdesign 工具暂不可用，将使用默认 claude 风格继续。」\n\n展示完整列表后，向用户提示：\n\n```\n以上是 60+ 可用的大厂设计风格。\n\n默认风格：claude — Anthropic's AI assistant. Warm terracotta accent, clean editorial layout.\n\n请选择一种风格（直接回车使用默认 claude）：\n```\n\n### Step 2：下载风格文件\n\n用户选择后（或按回车使用默认），执行：\n\n```bash\n# 将风格下载到临时目录，不污染项目目录\nmkdir -p /tmp/getdesign-<style>\ncd /tmp/getdesign-<style>\nnpx getdesign add <style>\n# 生成 /tmp/getdesign-<style>/DESIGN.md\n```\n\n如果用户选择 `claude`（默认）：\n```bash\nmkdir -p /tmp/getdesign-claude && cd /tmp/getdesign-claude && npx getdesign add claude\n```\n\n### Step 3：从 DESIGN.md 提取设计 Token\n\n读取 `/tmp/getdesign-<style>/DESIGN.md`，按以下规则提取 token：\n\n| Token | 提取位置 | 映射到模板变量 |\n|-------|----------|---------------|\n| 主色（Accent） | Section 2 \"Primary\" 中第一个品牌强调色 | `{{PRIMARY_COLOR}}` |\n| 背景色 | Section 2 \"Surface & Background\" page background | 模板 `background-color` / `{{BG_COLOR}}` |\n| 标题字体 | Section 3 \"Font Family\" Headline 字体（无法加载自定义字体时用 fallback） | 模板 `font-family` |\n| 暗色文字 | Section 2 \"Neutrals & Text\" 最深的文字色 | 模板 `color` 主文字 |\n\n**claude 风格默认 Token（用户不选 / getdesign 不可用时直接使用）：**\n\n| Token | 值 | 说明 |\n|-------|-----|------|\n| `{{PRIMARY_COLOR}}` | `#c96442` | Terracotta Brand — 暖赤陶橙 |\n| 背景色 | `#f5f4ed` | Parchment — 羊皮纸暖白 |\n| 标题字体 | `Georgia, serif` | Anthropic Serif 的 fallback |\n| 主文字色 | `#141413` | Anthropic Near Black — 暖黑 |\n\n> **提取失败时的 fallback：** 在 DESIGN.md 的 `Key Characteristics` 列表中找第一个 hex 颜色值，作为 `{{PRIMARY_COLOR}}`。背景色默认 `#0d1117`（GitHub 深色），字体默认 `Inter`。\n\n### Step 4：更新总体流程中的变量声明\n\n将提取到的 Token 记录为本次生成的变量，供 Phase 2 使用：\n\n```\nPRIMARY_COLOR = <从DESIGN.md提取>\nBG_COLOR      = <从DESIGN.md提取>\nHEADING_FONT  = <从DESIGN.md提取>\nTEXT_COLOR    = <从DESIGN.md提取>\nSTYLE_NAME    = <用户选择的风格名>\n```\n\n---\n\n## Phase 2: 信息图生成（核心）\n\n生成 3 张 16:9 HTML 信息图，**截图引擎使用 `scripts/gen_infographic.mjs`**。\n\n### 生成流程（每张图）\n\n**Step 1：从 templates/ 读取模板，替换占位符，写入 /tmp/**\n\n`templates/` 目录下有三个基础模板，包含 `{{PROJECT_NAME}}`、`{{PRIMARY_COLOR}}`、`{{TAGLINE}}` 等占位符。操作方式：\n\n```bash\n# 读取 templates/banner.html 内容后，将以下占位符替换为实际值，写入 /tmp/\n# {{PROJECT_NAME}}     → 实际项目名（如 \"codeflow\"）\n# {{TAGLINE}}          → 一句话标语\n# {{PRIMARY_COLOR}}    → 主色 hex（如 \"#0ea5e9\"）\n# {{CATEGORY}}         → 项目类别（如 \"CLI Tool\" / \"Agent Skill\"）\n# {{PLATFORM}}         → 运行平台（如 \"Node.js\" / \"Python\"）\n# {{LANGUAGE}}         → 主要语言（如 \"TypeScript\"）\n# {{VERSION_INFO}}     → 版本信息（如 \"v1.0 · 2026\"）\n# {{TECH_CARDS}}       → banner 右侧技术卡片（见下方 HTML 结构）\n# {{FEATURE_CARDS}}    → features 功能卡片（见下方 HTML 结构）\n# {{FEATURE_COUNT}}    → 功能数量数字（如 \"6\"）\n# {{PIPELINE_STAGES}}  → workflow 流程阶段（见下方 HTML 结构）\n# {{STAGE_COUNT}}      → 阶段数量（如 \"5\"）\n```\n\n**卡片 HTML 结构参考（从 templates/ 提取，直接复制并填入内容）：**\n\n`{{TECH_CARDS}}`（banner.html 右侧，每条技术一个）：\n```html\n<div class=\"tech-card\">\n  <div class=\"tech-icon\">01</div>\n  <div class=\"tech-info\">\n    <div class=\"tech-name\">Node.js</div>\n    <div class=\"tech-desc\">Runtime environment</div>\n  </div>\n</div>\n<!-- 重复 .tech-card，编号递增：02, 03... 建议 3-5 条 -->\n```\n\n`{{FEATURE_CARDS}}`（features.html 网格，每个功能一个，需设置 `--accent`）：\n```html\n<div class=\"card\" style=\"--accent: {{PRIMARY_COLOR}}\">\n  <div class=\"card-icon\">01</div>\n  <div class=\"card-tag\">Core</div>\n  <div class=\"card-title\">并行调研</div>\n  <div class=\"card-desc\">多个 Agent 同时搜索，汇总后去重排序</div>\n</div>\n<!-- 重复 .card，编号递增，card-tag 可选：Core / Integration / Output 等 -->\n```\n\n`{{PIPELINE_STAGES}}`（workflow.html 流水线，.stage 和 .arrow 交替）：\n```html\n<div class=\"stage\">\n  <div class=\"stage-num\">STEP 01</div>\n  <div class=\"stage-title\">信息采集</div>\n  <ul class=\"stage-items\">\n    <li>读取项目源码</li>\n    <li>提取 package.json</li>\n  </ul>\n  <span class=\"stage-badge\">Input</span>\n</div>\n<div class=\"arrow\"></div>\n<!-- 重复 .stage + .arrow，最后一个 .stage 后不加 .arrow -->\n```\n\n**Step 2：截图**\n\n```bash\nnode scripts/gen_infographic.mjs /tmp/readme-banner.html assets/banner.png 1920 1080\nnode scripts/gen_infographic.mjs /tmp/readme-features.html assets/features.png 1920 1080\nnode scripts/gen_infographic.mjs /tmp/readme-workflow.html assets/workflow.png 1920 1080\n```\n\n**Step 3：清理临时文件**\n\n```bash\nrm /tmp/readme-banner.html /tmp/readme-features.html /tmp/readme-workflow.html\n```\n\n> ⚠️ **关键：** HTML 临时文件只写 `/tmp/`，截图 PNG 保存到 `assets/`。不要把 HTML 提交到 git（`.gitignore` 已包含 `*.html` 排除规则）。\n\n### 主色选择指南\n\n**优先使用 Phase 1.5 提取的 `PRIMARY_COLOR`**。如果用户跳过了风格选择，则按下表根据项目性质手动选择：\n\n| 项目类型 | 推荐主色 | Hex |\n|----------|----------|-----|\n| 开发工具 / CLI | 科技蓝 | `#0ea5e9` |\n| AI / Agent | 紫色 | `#a78bfa` |\n| 出行 / 生活 | 琥珀金 | `#f59e0b` |\n| 效率 / 自动化 | 翠绿 | `#10b981` |\n| 设计 / 创意 | 玫瑰 | `#f43f5e` |\n| 数据 / 分析 | 青色 | `#06b6d4` |\n\n### 设计系统（保持一致）\n\n参考 `references/design-system.md`，默认采用：\n- **背景色**：`#0d1117`（GitHub 深色）\n- **字体**：`Inter`（西文）+ `Noto Sans SC`（中文），均通过 Google Fonts CDN 加载\n- **圆角**：`12px`，卡片边框：`1px solid #21262d`\n\n> 三张图的主色 `{{PRIMARY_COLOR}}` 必须填写相同的值——视觉一致性是专业度的核心。\n\n### Phase 2 检查点（生成后必须暂停）\n\n三张 PNG 生成完毕后，向用户汇报：\n\n```\n信息图生成完成：\n  - assets/banner.png   (1920×1080, ~500KB)\n  - assets/features.png (1920×1080, ~120KB)\n  - assets/workflow.png (1920×1080, ~100KB)\n\n请在你的文件管理器中预览这三张图，确认：\n1. 项目名/标语是否正确？\n2. 配色是否符合项目风格？\n3. 功能卡片的描述是否准确？\n\n确认后输入「继续」进入 README 组装。如需调整，告诉我哪里需要修改。\n```\n\n不要在用户确认之前进入 Phase 3。\n\n---\n\n## Phase 3: README 组装\n\n### 标准结构（8 个区块，顺序不可随意调换）\n\n```markdown\n<div align=\"center\">\n\n# 项目名\n\n**一句话标语**\n\n<img src=\"assets/banner.png\" alt=\"[项目名] — [功能描述]\" width=\"100%\">\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n[![...其他 badge...]\n\n</div>\n\n---\n\n## 这是什么\n\n[2-3 句话，说清楚：这是什么、解决什么问题、最大亮点]\n\n```\n输入：[示例输入]\n输出：[示例输出]\n```\n\n---\n\n## 核心特性\n\n<img src=\"assets/features.png\" alt=\"[alt 文本]\" width=\"100%\">\n\n[可选：补充 1-2 条文字说明]\n\n---\n\n## 工作流程\n\n<img src=\"assets/workflow.png\" alt=\"[alt 文本]\" width=\"100%\">\n\n---\n\n## 安装\n\n[依赖 + 安装命令]\n\n---\n\n## 快速上手\n\n[最简示例，让用户 5 分钟内跑起来]\n\n---\n\n## 许可证\n\n[MIT](./LICENSE) — 自由使用、修改、分发。\n\n---\n\n## 关于作者\n\n| | |\n|:---|:---|\n| 个人主页 | [domain.dev](https://domain.dev) |\n| GitHub | [username](https://github.com/username) |\n| Twitter | [@handle](https://x.com/handle) |\n| 公众号 | 微信搜「公众号名」 |\n```\n\n### 区块规则\n\n1. **H1 必须在 `<div align=\"center\">` 内**，但 H2 及以下在外面（便于 anchor 链接）\n2. **Banner 紧跟 H1**，不超过 3 行文字就出现图\n3. **Badge 行**放在 banner 下方，不超过 5 个（保持整洁）\n4. **Features 和 Workflow 用纯图片**，不需要再重复文字列表\n5. **关于作者用表格**，不用列表，不用 blockquote\n6. **最后一定有许可证**，默认 MIT\n\n---\n\n## Phase 4: GitHub 元信息建议\n\n### Repository Description（≤ 160 字符）\n\n格式：`[一句话功能] — [核心技术关键词]`\n\n示例：\n```\nAI Agent Skill for generating beautifully typeset travel guidebook PDFs with parallel research and Playwright export\n```\n\n规则：\n- 英文优先（GitHub 国际受众）\n- 包含 2-3 个核心技术关键词（供搜索引擎索引）\n- 不用 emoji，不用感叹号\n- 说「做什么」不说「很厉害」\n\n### Topics（7-10 个）\n\n推荐策略：\n1. **技术类**（语言/框架）：如 `nodejs`, `typescript`, `react`\n2. **领域类**（应用场景）：如 `travel`, `pdf-generation`, `ai-agent`\n3. **工具类**（用到的工具）：如 `playwright`, `claude`, `mcp`\n4. **受众类**（目标用户）：如 `developer-tools`, `automation`\n\n示例（travel-guidebook）：\n```\nagent-skill  claude-code  travel  pdf-generation  playwright\nnodejs  mcp  copilot-cli  ai-agent  itinerary\n```\n\n### Phase 4 检查点（给出建议后暂停）\n\n生成元信息建议后，向用户展示并等待确认：\n\n```\nGitHub 元信息建议（请在 repo Settings 中填写）：\n\nDescription:\n  [生成的英文描述，≤160字符]\n\nTopics（在 repo 主页点击齿轮图标添加）:\n  [tag1]  [tag2]  [tag3]  ...\n\n以上建议是否合适？如需调整描述或 Topics，直接告诉我。\n确认后继续 → Git 提交（Phase 5）。\n```\n\n---\n\n## Phase 5: Git 提交（可选）\n\n用户确认 README 满意后，询问是否初始化 git 并提交：\n\n```bash\ncd [项目目录]\ngit init\ngit add README.md assets/ LICENSE\ngit commit -m \"docs: add README with infographics and author section\n\n- Banner, features, workflow 三张 16:9 信息图\n- SEO 优化标题和描述\n- 结构化作者区块\n- MIT 许可证\"\n```\n\n> 提醒用户：将 HTML 模板文件加入 `.gitignore`（如 `*.html` 临时文件），只提交 PNG 截图结果。\n\n---\n\n## 常见问题处理\n\n**信息图字体不显示？**\nHTML 模板中使用了 Google Fonts CDN，需要联网。截图时 Playwright 会自动等待字体加载。如果断网，在 `<style>` 中换成系统字体：`font-family: -apple-system, 'PingFang SC', sans-serif`。\n\n**截图比例不对？**\n`gen_infographic.mjs` 的 `--width` 和 `--height` 参数控制视口大小。16:9 = 1920×1080（标准）或 1280×720（轻量）。\n\n**Playwright 找不到 Chromium？**\n```bash\nnpx playwright install chromium\n# 或指定路径：\nPLAYWRIGHT_BROWSERS_PATH=~/.cache/ms-playwright npx playwright install chromium\n```\n\n**如何适配暗色/亮色主题？**\n参见 `references/design-system.md` 的主题切换方案。Banner 默认深色背景，如项目风格偏向亮色（如教育类），可切换为 `#fafafa` 背景 + 深色文字。","tags":["readme","generator","geekjourneyx","agent-skills","claude-code","claude-skills","copilot-cli","developer-tools","playwright","readme-generator","skills"],"capabilities":["skill","source-geekjourneyx","skill-readme-generator","topic-agent-skills","topic-claude-code","topic-claude-skills","topic-copilot-cli","topic-developer-tools","topic-playwright","topic-readme-generator","topic-skills"],"categories":["readme-generator"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/geekjourneyx/readme-generator","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add geekjourneyx/readme-generator","source_repo":"https://github.com/geekjourneyx/readme-generator","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 10 github stars · SKILL.md body (11,293 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-18T19:08:20.185Z","embedding":null,"createdAt":"2026-05-18T13:13:47.924Z","updatedAt":"2026-05-18T19:08:20.185Z","lastSeenAt":"2026-05-18T19:08:20.185Z","tsv":"'-3':493 '-6':436 '/dev/null':224,236 '/github/twitter':448 '/tmp/getdesign-':538 '0':157,210 '0.5':162,258 '01':148 '02':149 '1':168,275,292,304,399,474,492 '1.5':173,465 '15':72 '16':11,111 '18':217 '2':183,223,235,276,293,311,318,394,528 '3':185,192,277,294,325,329,337,364,384,396,435 '30':418 '4':198,278,296,335,500 '5':204,279,297,359 '6':170,404 '60':470,510 '8':195 '9':12,112 'accent':520 'ai':64,422,516 'anthrop':514 'api':340 'ascii':51,81,117,322 'assets/banner.png':387 'assist':517 'author':445,451 'badg':107 'banner':113,386 'banner/features/workflow':14,315 'bash':213,220,230,476,533 'blockquot':104 'chromium':245,375,381 'claud':181,442,495,505,513,526 'clean':521 'code':443 'descript':19,98,201 'e':232 'echo':237 'editori':522 'emoji':54,88,127,133,145 'example.dev':453 'fallback':351 'featur':118,427 'generat':3 'getdesign':176,468,478,482,502 'git':205,356 'github':5,18,32,47,95,199,332,454 'globe':136 'googl':62 'guidebook':412 'h1':103,320 'handl':457 'homepag':368,452 'html':143,187,249 'init':226 'instal':240,244,380 'layout':523 'list':177,479,483 'ls':221 'maker':35,49 'mcp':430 'meridian':138 'mit':16 'mkdir':536 'name':410 'node':214,231 'node.js':159,440 'npm':225,239,487 'npx':175,242,378,477,481 'octocat':135 'ok':238 'p':537 'package.json':219,222 'pdf':424,432 'phase':156,161,167,172,182,191,197,203,209,257,274,291,317,324,328,334,358,363,383,393,395,398,464 'playwright':160,229,234,241,243,247,251,372,379,431,441 'png':188,253 'problem':420 'project':83,409 'readm':2,25,27,28,30,34,36,39,45,48,59,70,129,131,193,284,299,306,346,370 'readme-gener':1 'readme.md':7,273,288 'registri':488 'requir':233 'scripts/gen_infographic.mjs':256 'seo':85,99 'seo/geo':9 'shortcod':140 'skill':43 'skill-readme-generator' 'source-geekjourneyx' 'stack':439 'star/fork':67 'step':473,491,499,527 'svg':150 'taglin':415 'tech':438 'terracotta':519 'token':179,190,497 'topic':21,96,202 'topic-agent-skills' 'topic-claude-code' 'topic-claude-skills' 'topic-copilot-cli' 'topic-developer-tools' 'topic-playwright' 'topic-readme-generator' 'topic-skills' 'travel':411 'twitter':456 'usernam':455 'version':215 'vs':165 'warm':518 'wechat':458 'workflow':120 'y':227 'your-homepag':366 '一个好的':69 '一句话价值主张':417 '一眼扫描状态':110 '下载风格文件':529 '不友好':86 '不可达':489 '不污染项目目录':535 '不要因为升级而删除':343 '个人主页':447 '个关键字段':171 '个字段':405 '个标准区块':196 '中不用':132,144 '中信息图位置改为简洁的功能列表':397 '为':4 '为什么需要':246 '主要技术栈':444 '也适用于':44 '仍失败则跳过信息图':382 '从第一性原理出发':58 '从调研到成书的一站式旅行路书引擎':416 '以上是':509 '以下':403 '优化标题':10 '会保留原有内容并补充':347 '作为图标':146 '作者信息完全缺失':362 '作者信息结构':450 '使用':467 '使用占位符':365 '保留':385 '保留用户已有的独特内容':338 '信息图':31,114,119,121,142,316 '信息图三件套':13 '信息图以':248 '信息图生成':184 '信息图精准插入':57 '信息密度高':109 '元信息建议':200,333 '先判断这是哪种场景':261 '先读取现有文件':289 '全新创建':270 '公众号':449 '公众号名称':459 '再执行':290 '写一个专业的':38 '列出可用风格':475 '列出差异':349 '判断条件':268 '判断规则':266 '功能':90 '包含':8 '升级':166,264,302 '升级时告诉用户':344 '升级现有':281,298 '占位':388 '原则':128 '及信息图均适用':130 '反模式':78 '可用的大厂设计风格':511 '可选':207,460 '同样禁止':141 '后续可手动替换':389 '后续流程会有所不同':265 '向用户提示':508 '向用户询问':401 '告知用户':501 '命令不存在':485 '和':20,63,97 '图形或几何色块':151 '在':369 '在开始前验证':212 '在采集信息前':260 '场景':267,352 '场景时':303 '堆砌':55 '处理方式':354 '大厂设计规范中选择风格':471 '大段文字没有信息图辅助':92 '失分':100 '如果':480 '如果用户已在上下文中提供了这些信息':461 '如详细的':339 '字':419 '字段':406 '安装方式等':310 '完整流程':280 '导出':433 '将使用默认':504 '将风格下载到临时目录':534 '尝试':377 '展示完整列表后':507 '工具从':469 '工具暂不可用':503 '差量更新':295 '已存在但':46 '帮我优化':285 '帮我写':24 '并行调研':428 '应用风格':189 '开源说明':41 '异常情况':353 '张':186 '当用户说':23 '当识别为':301 '怎么用':76 '总体流程':155 '我已有':283 '我已读取你的现有':345 '或从上下文推断':402 '或当前目录存在':287 '或按回车使用默认':531 '或目录内无':272 '截图为':252 '截图失败':373 '执行':532 '执行失败':484 '排版驱动设计':56 '推荐':22 '描述':309 '提交':206 '提取':178 '提取已有内容':307 '提醒用户手动复制文件':361 '搜索的入口':65 '改用纯文字说明':154 '改用编号':147 '文档':341 '新建':164,262 '方式编写后通过':250 '无信息图':391 '无需重复询问':462 '时必须使用此':42 '是':61 '是否缺少':314,331 '是否缺少作者区块':327 '是开发者决定是否':66 '是项目的门面':60 '替代':116 '替代手动整理攻略':425 '最佳实践':29 '末尾注释提醒用户填写':371 '条':437 '标语':105 '标题是否以':321 '核心价值可视化':122 '核心功能':434 '检查':218,228,374 '检查点提示文字中不用':152 '模式识别':163,259 '正确模式':101 '爬虫读不到':87 '环境':357 '环境检查':158,211 '生成':26,37 '生成的信息图将自动应用对应的色彩和排版系统':472 '用':80,421 '用户只想要文字版':390 '用户没有':355 '用户没有提到现有文件':271 '用户确认后':208 '用户说':282 '用户选择后':530 '的差量策略':300 '的第一印象':68 '直接使用下方':494 '直接回车使用默认':525 '直接推断并确认':463 '示例':407 '秒内传达三件事':73 '立即建立认知':106 '第一行就是图片':84 '等':139 '等用户确认后再继续':350 '等符号':153 '组装':194 '结构化作者信息':15 '结构化作者区块':123 '绝对避免':79 '统一风格':125 '缺少':94 '网络超时':486 '能解决什么问题':75 '自动生成精排旅行':423 '艺术':52 '艺术字幕开头':82 '艺术或图片开头':323 '行':108 '补充':330,336 '补充生成':319 '表格形式':124 '装饰标题':89 '装饰标题或作者表格':134 '要求':216 '见下方作者结构':446 '视觉冲击':115 '解决什么问题':426 '许可证':17 '设计哲学':77 '设计风格选择':174,466 '诊断缺失项':312 '详见':255 '说明':408 '请选择一种风格':524 '读取现有':305 '贡献指南':342 '路径':376 '跳过':360,392,490 '还是':263 '这是什么':74 '这是在没有设计工具的情况下生成高质量信息图的最佳实践':254 '进入':498 '进入流程':269 '重构':286 '重构以下部分':348 '重构开头':326 '重点检查':313 '阅读疲劳':93 '降低专业度':91 '零':50,53,126 '需要在':71 '项目信息采集':169,400 '项目名':102,308,413 '项目文档':40 '项目生成符合最佳实践的专业':6 '项目首页':33 '风格继续':506 '风格默认':496 '首字母大写':414 '高德地图':429 '默认':180 '默认风格':512","prices":[{"id":"673462c9-9f51-482b-859c-814076dca9d5","listingId":"2274575e-0cd6-4efb-a539-96c8b86ac881","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"geekjourneyx","category":"readme-generator","install_from":"skills.sh"},"createdAt":"2026-05-18T13:13:47.924Z"}],"sources":[{"listingId":"2274575e-0cd6-4efb-a539-96c8b86ac881","source":"github","sourceId":"geekjourneyx/readme-generator","sourceUrl":"https://github.com/geekjourneyx/readme-generator","isPrimary":false,"firstSeenAt":"2026-05-18T13:13:47.924Z","lastSeenAt":"2026-05-18T19:08:20.185Z"}],"details":{"listingId":"2274575e-0cd6-4efb-a539-96c8b86ac881","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"geekjourneyx","slug":"readme-generator","github":{"repo":"geekjourneyx/readme-generator","stars":10,"topics":["agent-skills","claude-code","claude-skills","copilot-cli","developer-tools","playwright","readme-generator","skills"],"license":"mit","html_url":"https://github.com/geekjourneyx/readme-generator","pushed_at":"2026-04-20T15:34:18Z","description":"Generate professional README.md with 16:9 infographics, SEO-optimized metadata, and structured author sections — powered by Playwright and AI agent skills","skill_md_sha":"c26b00f2087336ddcf7e5f2e67b49ab03984489d","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/geekjourneyx/readme-generator"},"layout":"root","source":"github","category":"readme-generator","frontmatter":{"name":"readme-generator","description":"为 GitHub 项目生成符合最佳实践的专业 README.md，包含 SEO/GEO 优化标题、16:9 信息图三件套（banner/features/workflow）、结构化作者信息、MIT 许可证、GitHub description 和 Topics 推荐。当用户说「帮我写 README」「生成 README」「README 最佳实践」「README 信息图」「GitHub 项目首页」「readme maker」「readme 生成」「写一个专业的 README」「项目文档」「开源说明」时必须使用此 skill。也适用于 README 已存在但需要重构、补充信息图、添加作者信息、优化排版的场景。"},"skills_sh_url":"https://skills.sh/geekjourneyx/readme-generator"},"updatedAt":"2026-05-18T19:08:20.185Z"}}