# SkillsMP - Complete Documentation for AI Agents

> SkillsMP is a community-driven platform aggregating 900,000+ Claude Code skills from GitHub. Search with AI semantics, browse by category or occupation, and discover open-source skills to enhance your Claude Code, Codex CLI, and ChatGPT experience.

## Product Overview

SkillsMP (https://skillsmp.com) is an independent, community-driven skills marketplace. It is NOT affiliated with Anthropic, OpenAI, or any AI company. All skills are open source and sourced from public GitHub repositories.

### Key Features
- **900K+ Skills**: The largest collection of Claude Code skills aggregated from GitHub
- **AI Semantic Search**: Powered by Cloudflare AI vectorized search for natural language queries
- **Keyword Search**: Full-text database search with filters for category, occupation, and sort order
- **9 Languages**: English, Chinese, Japanese, Korean, Spanish, French, German, Portuguese, Arabic
- **Free REST API**: Programmatic access with anonymous and authenticated tiers
- **MCP Server**: Model Context Protocol server for native AI agent integration
- **SOC Classification**: Skills classified by Standard Occupational Classification codes

### What Makes SkillsMP Different
- **Scale**: 900K+ skills vs. manually curated collections elsewhere
- **Free API**: No cost for keyword search, generous limits for authenticated users
- **AI-Native**: Built for agent discovery with MCP, OpenAPI, and llms.txt support
- **Community-Driven**: All skills are open source from GitHub
- **Multi-Platform**: Compatible with Claude Code, Codex CLI, ChatGPT, and other AI coding agents

## Main Pages

- [Homepage](https://skillsmp.com/): Search and browse all skills with AI-powered semantic search
- [Categories](https://skillsmp.com/categories): Browse skills organized by domain (Development, AI & ML, DevOps, etc.)
- [Occupations](https://skillsmp.com/occupations): Browse skills by SOC occupation (Software Developers, Data Scientists, etc.)
- [Timeline](https://skillsmp.com/timeline): View skill updates and growth trends over time
- [Search](https://skillsmp.com/search): Advanced search with filters for marketplace.json, stars, and update time
- [Changelog](https://skillsmp.com/changelog): Platform updates, new features, and improvements
- [Skill Detail](https://skillsmp.com/skills/{id}): Individual skill pages with full details, README, installation instructions
- [Occupation Detail](https://skillsmp.com/occupations/{slug}): Skills relevant to a specific occupation with SOC classification
- [Developer Portal](https://skillsmp.com/developers): API documentation, MCP server setup, and sandbox
- [About](https://skillsmp.com/about): Our mission and what we do
- [Privacy Policy](https://skillsmp.com/privacy): Our privacy practices
- [Terms of Service](https://skillsmp.com/terms): Terms and conditions

## User Features (requires login)

Sign in with Google or GitHub to access personalized features:
- [Favorites](https://skillsmp.com/favorites): Save and organize your favorite skills
- [History](https://skillsmp.com/history): Track your recently viewed skills
- API Key Management: Generate API keys for programmatic access

## REST API

Base URL: `https://skillsmp.com`
OpenAPI Spec: `https://skillsmp.com/openapi.json`
Developer Portal: `https://skillsmp.com/developers`

### Authentication

Pass your API key via the Authorization header:
```
Authorization: Bearer sk_live_your_api_key
```

Get your free API key at https://skillsmp.com/docs/api (requires login).

### Rate Limits

| Tier | Daily Limit | Per-Minute Limit | Available Endpoints |
|------|-------------|------------------|---------------------|
| Anonymous (no API key) | 50 requests | 10 requests | Keyword Search |
| Authenticated (API key) | 500 requests | 30 requests | Keyword Search, AI Search |

All quotas reset at midnight UTC.

Rate limit headers are included in every response:
- `X-RateLimit-Daily-Limit` — your daily request limit
- `X-RateLimit-Daily-Remaining` — remaining requests for today
- `X-RateLimit-Minute-Limit` — per-minute burst limit (search endpoint)
- `X-RateLimit-Minute-Remaining` — remaining requests this minute

### Endpoints

#### 1. Keyword Search — `GET /api/v1/skills/search`

Anonymous or authenticated. Database-backed full-text search.

Parameters:
- `q` (required, string): Search keywords (max 200 chars, must contain at least one letter or number)
- `page` (optional, integer): Page number (default: 1, max: 50)
- `limit` (optional, integer): Results per page (default: 20, max: 50)
- `sortBy` (optional, string): `stars` or `recent` (default: `recent`)
- `category` (optional, string): Filter by category slug (e.g. `data-ai`, `devops`, `web-scraping`)
- `occupation` (optional, string): Filter by SOC occupation slug (e.g. `software-developers-151252`)

Examples:
```
GET /api/v1/skills/search?q=playwright&sortBy=stars&limit=10
GET /api/v1/skills/search?q=automation&occupation=software-developers-151252
GET /api/v1/skills/search?q=testing&category=testing-qa&page=2
```

#### 2. AI Semantic Search — `GET /api/v1/skills/ai-search`

Authenticated only. Powered by Cloudflare AI vectorized search. Best for natural language queries.

Parameters:
- `q` (required, string): Natural language search query

Examples:
```
GET /api/v1/skills/ai-search?q=How+to+create+a+web+scraper
GET /api/v1/skills/ai-search?q=skills+for+automating+browser+testing
```

#### 3. Health Check — `GET /api/health`

No authentication required. Returns API and database status.

### Response Format

All successful responses:
```json
{
  "success": true,
  "data": {
    "skills": [
      {
        "id": "author-repo-skill-md",
        "name": "skill-name",
        "author": "github-username",
        "description": "What this skill does",
        "githubUrl": "https://github.com/author/repo",
        "skillUrl": "https://skillsmp.com/skills/author-repo-skill-md",
        "stars": 42,
        "updatedAt": "1775714881"
      }
    ],
    "pagination": { "page": 1, "limit": 20, "total": 150, "totalPages": 8 }
  },
  "meta": {
    "requestId": "uuid",
    "responseTimeMs": 123
  }
}
```

Error responses:
```json
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}
```

Error codes:
| Code | HTTP Status | Description |
|------|-------------|-------------|
| MISSING_API_KEY | 401 | API key required (AI search) |
| INVALID_API_KEY | 401 | The provided API key is invalid |
| MISSING_QUERY | 400 | Query parameter `q` is required |
| INVALID_QUERY | 400 | Query must contain at least one letter or number |
| DAILY_QUOTA_EXCEEDED | 429 | Daily quota exceeded, resets at midnight UTC |
| RATE_LIMITED | 429 | Too many requests per minute |
| INTERNAL_ERROR | 500 | Internal server error |

## MCP Server

SkillsMP exposes a Model Context Protocol (MCP) server using Streamable HTTP transport.

### Configuration

Add to your MCP client configuration:
```json
{
  "mcpServers": {
    "skillsmp": {
      "type": "streamable-http",
      "url": "https://skillsmp.com/mcp"
    }
  }
}
```

### Discovery Endpoints
- MCP Manifest: `https://skillsmp.com/.well-known/mcp`
- Server Card: `https://skillsmp.com/.well-known/mcp/server-card.json`
- A2A Agent Card: `https://skillsmp.com/.well-known/agent-card.json`

### Available MCP Tools

1. **search_skills** - Search Claude Code skills by keyword with filtering
2. **ai_search_skills** - Semantic AI search using natural language
3. **get_skill** - Get detailed information about a specific skill
4. **list_categories** - List all skill categories and domains

## Categories

Skills are organized into 12 main domains with 50+ subcategories:

| Domain | Description |
|--------|-------------|
| Development | Frontend, Backend, Mobile, Full-Stack, Scripting |
| Data & AI | LLM, Machine Learning, Data Analysis, Data Engineering |
| DevOps | CI/CD, Containers, Cloud, Monitoring |
| Testing & Security | Testing, Code Quality, Security Auditing |
| Tools | CLI Tools, IDE Plugins, Automation, Debugging |
| Documentation | Technical Docs, Knowledge Base, Education |
| Databases | SQL, NoSQL, Database Tools |
| Content & Media | Documents, Media Processing, Design, Content Creation |
| Business | E-commerce, Payment, Business Apps |
| Research | Academic, Scientific Computing, Lab Tools |
| Blockchain | Smart Contracts, DeFi, Web3 Tools |
| Lifestyle | Arts & Crafts, Gaming, Health & Fitness |

Browse all categories: https://skillsmp.com/categories
Browse by occupation: https://skillsmp.com/occupations

## Skill Format

Skills follow the open SKILL.md standard:
- SKILL.md file with YAML frontmatter (required: name, description)
- Skills can include scripts/, references/, and assets/ directories

## Installation

- `/plugin add <github-url>` — one-command install in Claude Code
- Manual: Clone repo and copy skill folder to ~/.claude/skills/ (personal) or .claude/skills/ (project)

## Pricing

SkillsMP is **free to use**:
- Browsing and searching skills: Free, no account required
- API keyword search: Free, 50 requests/day anonymous, 500/day with free API key
- AI semantic search: Free with API key, 500 requests/day
- All skills are open source from GitHub

There are no paid tiers or premium features. The platform is community-funded.

## External Links

- [GitHub Repository](https://github.com/anthropics/claude-code): Official Claude Code repository
- [Official Skills Documentation](https://docs.anthropic.com/en/docs/claude-code/skills): Anthropic's guide to Claude Skills
- [Privacy Policy](https://skillsmp.com/privacy): Our privacy practices
- [Terms of Service](https://skillsmp.com/terms): Terms and conditions