Skill History
Track download history for 70,000+ agent skills. Search and get daily snapshots.
Open source Repository Open in the app JSON README (API)
About
Track download history for 70,000+ agent skills. Search and get daily snapshots.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- pineapple-farm
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 5
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-09-02T05:59:16Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:01
- Updated
- 2026-08-29 04:01:01
- Origin id
io.github.pineapple-farm/skill-history
README
# skill-history
Track 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.
[skill-history.com](https://skill-history.com) · built by [Pineapple AI](https://pineappleai.com)
[](https://skill-history.com/gavinlinasd/self-preserve)
## How it works
skill-history.com tracks daily download counts for all 54,000+ skills on ClawHub. Every skill gets a chart page and an embeddable SVG:
- **Chart page** — `skill-history.com/{handle}/{slug}`
- **SVG embed** — `skill-history.com/chart/{handle}/{slug}.svg`
- **Compact badge** — `skill-history.com/badge/{handle}/{slug}.svg`
Your `{handle}` is your GitHub username (ClawHub uses GitHub OAuth), and `{slug}` is your skill's slug on ClawHub.
### Add to your README
```markdown
[](https://skill-history.com/YOUR_HANDLE/YOUR_SLUG)
```
Or use the link generator at [skill-history.com](https://skill-history.com).
## Architecture
- **Cloudflare Workers + Hono** — serves the site, chart SVGs, and scheduled sweeps
- **Cloudflare D1 (SQLite)** — stores skills and daily snapshots
- **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
- **d3-shape** — smooth monotone curves (same algorithm as star-history)
- **Data source** — ClawHub public API, sweeps every 2 hours
## API
All skill pages return JSON when requested with `Accept: application/json`:
```bash
curl -H "Accept: application/json" https://skill-history.com/gavinlinasd/self-preserve
```
Full OpenAPI spec at [skill-history.com/api/openapi.json](https://skill-history.com/api/openapi.json).
For AI agents: [skill-history.com/llms.txt](https://skill-history.com/llms.txt).
## Local development
```bash
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
```
## Roadmap
- [x] Daily download tracking for all ClawHub skills
- [x] Embeddable SVG chart + compact badge
- [x] Landing page with link generator
- [x] Agent discoverability (llms.txt, OpenAPI)
- [ ] Smooth d3-powered chart rendering (full axis upgrade)
- [ ] Multi-source tracking (GitHub stars, non-ClawHub installs)
- [ ] Comparison charts (overlay multiple skills)
- [ ] Weekly "fastest growing skills" reports
- [ ] MCP server for agent tool access
Have an idea? [Open an issue](https://github.com/pineapple-farm/skill-history/issues/new) or submit a PR — we'd love your input.
## Contributing
This is a brand new project and we're actively shaping it based on what skill authors actually want. Contributions welcome:
- **Feature requests** — [open an issue](https://github.com/pineapple-farm/skill-history/issues/new) describing what you'd like to see
- **Bug reports** — if a chart looks wrong or a skill is missing, let us know
- **Pull requests** — code, docs, or design improvements are all welcome
- **Data sources** — ideas for tracking skills beyond ClawHub (GitHub stars, other registries)
## License
MIT