API Reference
REST API documentation for developers
Base URL
https://skills.palebluedot.liveAuthentication
Most endpoints are public and require no authentication. Endpoints that modify user data require GitHub OAuth authentication via session cookies.
Sign in at skills.palebluedot.live to create a session. Authenticated endpoints return 401 if no valid session exists.
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
Newsletter
Subscribe and unsubscribe from the newsletter
Subscribe an email to the newsletter
Unsubscribe an email from the newsletter