用途：优化 GitHub 仓库在 GitHub 搜索与网页搜索中的可发现性，重点调整仓库元数据层，而非堆砌 README 关键词。
主要能力：审计并改进仓库描述（About 文本与搜索摘要，一句话含类别关键词、受众与成果，≤350 字符）、topics（5–10 个，覆盖类别、语言、用例、领域，小写连字符，每个≤35 字符，仅用准确标签）、名称与 README H1 对齐、homepage 链接、社交预览图提示，以及标题与链接写法（任务型 ## 标题、描述性锚文本）。
使用方式：先运行只读审计脚本 python3 "${CLAUDE_SKILL_DIR}/scripts/check_discoverability.py" [owner/repo]，查看各杠杆的 pass/warn/fail；再阅读 references/discoverability-playbook.md，按优先级修复。设置描述用 gh repo edit <owner/repo> --description "..."；添加 topics 用 gh repo edit <owner/repo> --add-topic <t1> --add-topic <t2> ...；设置主页用 gh repo edit --homepage <url>。社交预览图无法通过 CLI 设置，需在 Settings → General → Social preview 上传 1280×640 图片。修改前先向用户展示描述与 topics 的前后对比，改完重跑脚本确认。
适用场景：仓库元数据整理、公开前准备、搜索曝光优化。
限制：不负责 README 内容撰写或重构（交给 readme-author）、社区文件与模板、文档网站建设、推广营销建议。私有仓库不被搜索收录，可先备好元数据；GitHub 搜索偏好活跃仓库，新鲜度无法靠元数据伪造；不要承诺具体流量或 star 增长数字；避免关键词堆砌。完整搜索控制（标题标签、meta 描述、结构化数据）属于 docs/Pages 站点，仓库页无法实现。