>_

API Reference

The Agent Skills Marketplace provides a public API for programmatic access.

Overview

The API allows you to:

  • Search and browse skills
  • Get skill details
  • List categories
  • Access skill statistics

Base URL

https://skillsmp.com/api/v1

Authentication

Most endpoints are public and don't require authentication.

For rate-limited or user-specific endpoints, include an API key:

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://skillsmp.com/api/v1/skills

Rate Limits

| Tier | Requests/Hour | Notes | |------|---------------|-------| | Anonymous | 100 | No auth required | | Authenticated | 1,000 | API key required | | Premium | 10,000 | Contact us |

Rate limit headers:

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1640995200

Response Format

All responses are JSON:

json
{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Error responses:

json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Skill not found"
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

Endpoints

Quick Examples

List Skills

bash
curl https://skillsmp.com/api/v1/skills

Search Skills

bash
curl "https://skillsmp.com/api/v1/skills/search?q=react"

Get Skill Details

bash
curl https://skillsmp.com/api/v1/skills/owner/repo

List Categories

bash
curl https://skillsmp.com/api/v1/categories

SDKs

JavaScript/TypeScript

bash
npm install @aiskills/sdk
typescript
import { SkillsClient } from '@aiskills/sdk';

const client = new SkillsClient();

const skills = await client.skills.list({
  category: 'development',
  limit: 10
});

Python

bash
pip install aiskills
python
from aiskills import SkillsClient

client = SkillsClient()

skills = client.skills.list(
    category='development',
    limit=10
)

Webhooks

Subscribe to events for real-time updates:

  • skill.created - New skill added
  • skill.updated - Skill content updated
  • skill.deleted - Skill removed

Contact us for webhook access.

Support

Edit this page on GitHub