{
  "markdown": "# skill-history\n\nTrack and visualize agent skill download history from [ClawHub](https://clawhub.ai). An embeddable chart for READMEs — [star-history](https://star-history.com), but for agent skills.\n\n[skill-history.com](https://skill-history.com) · built by [Pineapple AI](https://pineappleai.com)\n\n[![Download History](https://skill-history.com/chart/gavinlinasd/self-preserve.svg)](https://skill-history.com/gavinlinasd/self-preserve)\n\n## How it works\n\nskill-history.com tracks daily download counts for all 54,000+ skills on ClawHub. Every skill gets a chart page and an embeddable SVG:\n\n- **Chart page** — `skill-history.com/{handle}/{slug}`\n- **SVG embed** — `skill-history.com/chart/{handle}/{slug}.svg`\n- **Compact badge** — `skill-history.com/badge/{handle}/{slug}.svg`\n\nYour `{handle}` is your GitHub username (ClawHub uses GitHub OAuth), and `{slug}` is your skill's slug on ClawHub.\n\n### Add to your README\n\n```markdown\n[![Download History](https://skill-history.com/chart/YOUR_HANDLE/YOUR_SLUG.svg)](https://skill-history.com/YOUR_HANDLE/YOUR_SLUG)\n```\n\nOr use the link generator at [skill-history.com](https://skill-history.com).\n\n## Architecture\n\n- **Cloudflare Workers + Hono** — serves the site, chart SVGs, and scheduled sweeps\n- **Cloudflare D1 (SQLite)** — stores skills and daily snapshots\n- **Edge cache** — GET responses are stored in Cloudflare's cache via the Cache API (`caches.default`), so D1 only sees cache misses; weekly blog data is materialised in D1 once per week\n- **d3-shape** — smooth monotone curves (same algorithm as star-history)\n- **Data source** — ClawHub public API, sweeps every 2 hours\n\n## API\n\nAll skill pages return JSON when requested with `Accept: application/json`:\n\n```bash\ncurl -H \"Accept: application/json\" https://skill-history.com/gavinlinasd/self-preserve\n```\n\nFull OpenAPI spec at [skill-history.com/api/openapi.json](https://skill-history.com/api/openapi.json).\n\nFor AI agents: [skill-history.com/llms.txt](https://skill-history.com/llms.txt).\n\n## Local development\n\n```bash\nnpm install\n\n# Authenticate with Cloudflare\nwrangler login\n\n# Create D1 database, copy database_id into wrangler.jsonc\nwrangler d1 create skill-history\n\n# Apply schema to local dev DB\nnpm run db:migrate:local\n\n# Run locally\nnpm run dev\n```\n\n## Roadmap\n\n- [x] Daily download tracking for all ClawHub skills\n- [x] Embeddable SVG chart + compact badge\n- [x] Landing page with link generator\n- [x] Agent discoverability (llms.txt, OpenAPI)\n- [ ] Smooth d3-powered chart rendering (full axis upgrade)\n- [ ] Multi-source tracking (GitHub stars, non-ClawHub installs)\n- [ ] Comparison charts (overlay multiple skills)\n- [ ] Weekly \"fastest growing skills\" reports\n- [ ] MCP server for agent tool access\n\nHave an idea? [Open an issue](https://github.com/pineapple-farm/skill-history/issues/new) or submit a PR — we'd love your input.\n\n## Contributing\n\nThis is a brand new project and we're actively shaping it based on what skill authors actually want. Contributions welcome:\n\n- **Feature requests** — [open an issue](https://github.com/pineapple-farm/skill-history/issues/new) describing what you'd like to see\n- **Bug reports** — if a chart looks wrong or a skill is missing, let us know\n- **Pull requests** — code, docs, or design improvements are all welcome\n- **Data sources** — ideas for tracking skills beyond ClawHub (GitHub stars, other registries)\n\n## License\n\nMIT\n",
  "bytes": 3401,
  "sha": "82679ff4e31960b6698388230ac1c5695cafc3416393d638e6ae0711203b8200",
  "repo_slug": "pineapple-farm/skill-history",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pineapple_farm_skill_history_1b12c194/readme"
}