Skill History

skill-history

跟踪并可视化来自 ClawHub 的 Agent 技能下载历史。可嵌入 README 的图表——类似 star-history，但面向 Agent 技能。

skill-history.com · 由 Pineapple AI 构建

工作原理

skill-history.com 跟踪 ClawHub 上全部 54,000 多个技能的每日下载次数。每个技能都有一个图表页面和一个可嵌入的 SVG：

• 图表页面 — skill-history.com/{handle}/{slug}
• SVG 嵌入 — skill-history.com/chart/{handle}/{slug}.svg
• 紧凑徽章 — skill-history.com/badge/{handle}/{slug}.svg

你的 {handle} 是 GitHub 用户名（ClawHub 使用 GitHub OAuth），{slug} 是你的技能在 ClawHub 上的 slug。

添加到你的 README

[![Download History](https://skill-history.com/chart/YOUR_HANDLE/YOUR_SLUG.svg)](https://skill-history.com/YOUR_HANDLE/YOUR_SLUG)

也可以使用 skill-history.com 上的链接生成器。

架构

• Cloudflare Workers + Hono — 提供网站、图表 SVG 和定时扫描服务
• Cloudflare D1 (SQLite) — 存储技能和每日快照
• 边缘缓存 — GET 响应通过 Cache API（caches.default）存储在 Cloudflare 的缓存中，因此只有缓存未命中时才会访问 D1；每周博客数据每周在 D1 中物化一次
• d3-shape — 平滑的单调曲线（与 star-history 使用相同的算法）
• 数据来源 — ClawHub 公共 API，每 2 小时扫描一次

API

所有技能页面在请求头中指定 Accept: application/json 时都会返回 JSON：

curl -H "Accept: application/json" https://skill-history.com/gavinlinasd/self-preserve

完整的 OpenAPI 规范见 skill-history.com/api/openapi.json。

AI Agent 可参考：skill-history.com/llms.txt。

本地开发

npm install

# Authenticate with Cloudflare
wrangler login

# Create D1 database, copy database_id into wrangler.jsonc
wrangler d1 create skill-history

# Apply schema to local dev DB
npm run db:migrate:local

# Run locally
npm run dev

路线图

• 跟踪 ClawHub 上所有技能的每日下载量
• 可嵌入的 SVG 图表 + 紧凑徽章
• 带链接生成器的着陆页
• 便于 Agent 发现（llms.txt、OpenAPI）
• 由 d3 驱动的平滑图表渲染（完整坐标轴升级）
• 多来源跟踪（GitHub 星标、非 ClawHub 安装量）
• 对比图表（叠加多个技能）
• 每周“增长最快的技能”报告
• 用于 Agent 访问工具的 MCP 服务

有想法？提交 issue 或提交 PR——我们期待你的意见。

参与贡献

这是一个全新的项目，我们正根据技能作者的实际需求积极完善它。欢迎贡献：

• 功能请求 — 提交 issue，描述你希望看到的功能
• 错误报告 — 如果图表显示不正确，或缺少某个技能，请告诉我们
• 拉取请求 — 欢迎提交代码、文档或设计改进
• 数据来源 — 提出跟踪 ClawHub 之外技能的想法（GitHub 星标、其他注册表）

许可证

MIT