// api

API Reference

REST API documentation for developers

AI Score is the primary quality signal

AI Score (0–100) is the primary quality signal — produced by an automated review of each skill's SKILL.md. The user-rating system has been removed from the UI; the /api/ratings endpoints are kept for backward compatibility and are now deprecated. The rating/ratingCount fields in /api/skills responses are typically null — rely on aiScore.

Base URL

https://skills.palebluedot.live

Authentication

Most endpoints are public and require no authentication. Endpoints that modify user data require GitHub OAuth authentication via session cookies.

Rate Limiting

All endpoints are rate-limited using a sliding window algorithm. Rate limit headers are included in responses.

Tier	Limit	Used For
Anonymous	120 req/min	Public read endpoints
Search	60 req/min	Search and file fetching
Authenticated	600 req/min	User actions (logged in)

Response Headers

X-RateLimit-Limit — Maximum requests per window

X-RateLimit-Remaining — Remaining requests in current window

X-RateLimit-Reset — Unix timestamp when the window resets

Error Responses

All errors follow a consistent JSON format.

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded",
  "retryAfter": 45,
  "limit": 60
}

Common Status Codes

400 — Bad Request — Missing or invalid parameters

401 — Unauthorized — Authentication required

404 — Not Found — Resource does not exist

429 — Too Many Requests — Rate limit exceeded

500 — Internal Server Error

Quick Example

curl "https://skills.palebluedot.live/api/skills?q=code-review&limit=5"

Skills

Search, browse, and retrieve skill information

Search skills with full-text search, filters, and pagination

Get detailed information about a specific skill

Get featured and popular skills

Get recently added or updated skills

Track a skill installation

Request a new skill to be indexed

Request removal of a skill you own

Skill Files

Fetch skill file contents and download as ZIP

Get all files in a skill folder with content

Download skill files as a ZIP archive

User Actions

Ratings, favorites, and skill management

Get ratings and reviews for a skill

Create or update your rating for a skill

Get your own rating for a specific skill

Get your list of favorited skills

Add a skill to your favorites

Remove a skill from your favorites

Check which skills are in your favorites

Discovery & Metadata

Categories, statistics, and platform health

Get all skill categories with counts

Get global marketplace statistics

Check API and service health status

Get attribution and data source statistics

Subscribe and unsubscribe from the newsletter

Subscribe an email to the newsletter

Unsubscribe an email from the newsletter