API Reference - Documentation

Agent Skills Index provides a public API for accessing skill data programmatically.

Base URL

https://agentskillsindex.com/api

Authentication

Public endpoints do not require authentication. Rate limiting applies to all requests.

Endpoints

GET /api/skills

List all skills with pagination and filtering

Query Parameters

q	Search query string
category	Filter by category slug
sort	Sort by: stars, newest, updated, name
page	Page number (default: 1)

GET /api/skills/:owner/:repo

Get details of a specific skill

Response

{
  "id": "uuid",
  "name": "Skill Name",
  "description": "...",
  "github_owner": "owner",
  "github_repo": "repo",
  "stars": 100,
  "forks": 10,
  "language": "Python",
  "skill_md_content": "...",
  "categories": [...]
}

GET /api/categories

List all skill categories

Rate Limiting

API requests are limited to 100 requests per minute per IP address. Rate limit headers are included in all responses:

X-RateLimit-Limit: Maximum requests per minute
X-RateLimit-Remaining: Remaining requests
X-RateLimit-Reset: Time until limit resets

Feeds

We also provide RSS and Atom feeds for the latest skills:

https://agentskillsindex.com/rss - RSS 2.0
https://agentskillsindex.com/atom - Atom 1.0