An open-source directory and scoring platform for AI Agent skills, MCP servers, and Agent tools, covering 62,000+ GitHub projects with 6-dimension quality evaluation and 9-signal composite scoring.
AgentSkillsHub is an aggregated directory and quality scoring platform for the AI Agent ecosystem. Through a fully automated data pipeline (executed every 8 hours), it collects 62,000+ relevant open-source repositories from GitHub, processes them through 6 stages (collection, cleaning, classification, quality evaluation, composite scoring, presentation), and provides one-stop tool discovery and comparison for users of Agent IDEs such as Claude Code, Cursor, Windsurf, Cline, and OpenAI Codex.
Core capabilities include: 6-dimension quality evaluation (Completeness, Clarity, Specificity, Examples, README Structure, Agent Readiness) and 9-signal composite scoring (0-100 scale), covering 7 major categories (mcp-server, claude-skill, codex-skill, agent-tool, prompt-library, ai-coding-assistant) and 53 use-case scenarios. Supports full-text search (PostgreSQL tsvector + GIN index), side-by-side project comparison, TF-IDF skill pairing recommendations, and automatic identification of 17 target platforms.
Technically, the backend uses Python 3.12 + FastAPI + SQLAlchemy, the frontend uses React 18 + TypeScript + Vite + TailwindCSS v4, with Supabase (PostgreSQL) for production and SQLite for local development. Deployment is handled via GitHub Actions and GitHub Pages. It provides a complete REST API (13 endpoints including search, leaderboards, submission, and subscription), RSS Feed, Newsletter subscription, a Verified Creator program, and enterprise features (security audit, SBOM, compliance labels, private mirror).
Quick Start
Backend:
cd backend
python3.12 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # Requires GITHUB_TOKEN
uvicorn app.main:app --reload
Frontend:
cd frontend
npm install
npm run dev
REST API Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/skills | Paginated list (search, filter, sort) |
| GET | /api/skills/{id} | Skill details + compatible skill recommendations |
| GET | /api/trending | 7-day star growth leaders |
| GET | /api/rising | New additions this week |
| GET | /api/top-rated | Highest rated |
| GET | /api/most-starred | Community classics (6+ months) |
| GET | /api/masters | Verified creators |
| GET | /api/landing | Homepage aggregated data |
| GET | /api/stats | Statistics summary |
| GET | /api/feed.xml | RSS 2.0 |
| GET | /api/sitemap.xml | SEO Sitemap |
| POST | /api/submit-skill | Submit a GitHub repository |
| POST | /api/subscribe | Newsletter subscription |
Key Environment Variables
| Variable | Description |
|---|---|
GITHUB_TOKEN | GitHub API access token (required) |
SUPABASE_DB_URL | Production database connection |
RESEND_API_KEY | Email service key |
ADMIN_TOKEN | Admin API authentication |
SYNC_INTERVAL_HOURS | Sync frequency (default 8h) |
Unconfirmed Information: Open-source license type is not explicitly stated in README or website pages; no versioned releases published; discrepancy between homepage's "17,000+ Skills" and README's "62,000+ projects" is not documented.