awesome-skills/github-repo-insights

将 GitHub Traffic 转化为有据可查的增长故事。

GitHub Repo Insights 是一款 agent skill，旨在了解仓库的实际增长情况。它结合了 GitHub Traffic、star 事件、referrers、popular paths、releases 和社区信号——然后将观察到的事实与解读区分开来。 ## 它能解答什么问题 | 问题 | 使用的证据 | | --- | --- | | **有更多人发现这个项目吗？** | 14 天浏览量和独立访客数 | | **他们有足够的兴趣去尝试吗？** | Clones 和独立克隆数 | | **增长是在加速还是在衰退？** | 近 7 天与前 7 天对比、每日峰值、star 事件 | | **关注度来自哪里？** | GitHub、搜索引擎、社交媒体、社区及其他 referrers | | **访客关心什么？** | README、文档、releases、issues 及其他 popular paths | | **我们接下来应该改进什么？** | 关联证据的 onboarding、本地化、release 和分发操作 | ## 安装 ``` npx skills@latest add awesome-skills/github-repo-insights -g -y ``` 环境要求：Python 3.10+ 及已通过身份验证的 [GitHub CLI](https://cli.github.com/)。 ``` gh auth status ``` Repository Traffic 需要 push 权限。对于没有 push 权限的公开仓库，该 skill 仍会报告公开元数据、star 动能、releases 和社区信号——并明确将私有的 Traffic 数据标记为不可用，而不是假装其为零。 ## 询问你的 agent ``` Use $github-repo-insights to analyze why this repository is growing. ``` ``` Compare the latest 7 days with the previous 7 days and tell me what to improve next. ``` ``` Where did this repository's traffic come from, and which pages are people reading? ``` 或者直接收集规范化的 JSON 快照： ``` python3 scripts/collect_github_repo_insights.py OWNER/REPO \ --output /tmp/github-repo-insights.json ``` 在本地 Git checkout 中，可以省略 `OWNER/REPO`，它会自动被检测。 ## 快照示例 对 [`tt-a1i/archify`](https://github.com/tt-a1i/archify) 在 **2026-07-02 → 2026-07-15** 期间的分析发现： | 指标 | 结果 | | --- | ---: | | 浏览量 | **23,877** | | 独立访客数 | **11,062** | | Clones | **6,902** | | 独立克隆数 | **4,320** | | 单日 star 峰值 | **552**（7 月 15 日） | 记录中最强的 referrers 是 GitHub、X / `t.co` 和 Google。中文 README 已经是该仓库浏览量第三高的路径，这表明本地化正在带来可衡量的需求。 ## 为如实报告而构建 - **窗口总数始终为总数。** 每日独立访客数和独立克隆数绝不会被累加。 - **不可用不等于零。** 缺失的权限和不完整的历史记录依然可见。 - **比率仅作方向性参考。** Stars-per-view 和 clones-per-view 不会作为用户转化率呈现。 - **相关性不等于因果关系。** Releases、文章发布、Trending 上榜和流量激增只有在日期和证据支持该推断时才会被联系起来。 - **下一步行动紧随瓶颈。** 建议与数据中发现的获客、onboarding、本地化、打包或留存信号紧密相连。 ## 收集哪些内容 ``` GitHub REST API repository · traffic · referrers · popular paths · releases GitHub GraphQL API timestamped star events and daily momentum Collector normalized JSON · 7d comparisons · peak dates · warnings Agent skill evidence-backed interpretation and next actions ``` 指标定义和重要的 GitHub API 限制记录在 [`references/metrics.md`](references/metrics.md) 中。 ## 许可证 [MIT](LICENSE) © Awesome Skills

标签：Python, 代码示例, 数据分析, 无后门