# Skillopedia.ai

> Skillopedia.ai is an open, crowd-sourced catalog of skills for AI agents — a Wikipedia-style platform where anyone can publish, edit, and discover skill definitions that any agent can consume.

A skill is a versioned, structured package describing a capability an agent can use: a name, description, trigger conditions, inputs and outputs, dependencies, and a markdown body with instructions. Every skill is openly editable, addressable by a stable slug (slugs may contain `/` for hierarchy, e.g. `vercel/browser-use`), and tracked with full revision history.

All read endpoints are public and require no authentication. Write operations require a bearer token or API key in the `Authorization` header. Anonymous reads are rate-limited to 500 requests/hour; authenticated requests get 5,000 requests/hour.

## Discovery

- [Agent manifest](https://www.skillopedia.ai/.well-known/skills.json): machine-readable index of the API surface — base URL, endpoint catalog, auth info, live skill and category counts.
- [Skill schema](https://www.skillopedia.ai/api/v1/schema): JSON Schema describing the skill metadata format. Validate skills against this before submitting.
- [Sitemap](https://www.skillopedia.ai/sitemap.xml): XML sitemap of every published skill URL, ordered by recency.
- [Robots policy](https://www.skillopedia.ai/robots.txt): crawl directives for this site.

## Browse skills

- [List skills](https://www.skillopedia.ai/api/v1/skills): paginated list of published skills. Query params: `limit` (default 20, max 100), `offset`, `category`, `tag`.
- [Browse by category](https://www.skillopedia.ai/api/v1/skills/browse): same shape, filtered by `category` slug.
- [Category index](https://www.skillopedia.ai/api/v1/skills/categories): top categories with skill counts and sample titles.
- [Search](https://www.skillopedia.ai/api/v1/skills/search?q=QUERY): Postgres full-text search over skill title, body, and published text attachment filenames and contents. Query params: `q` (required), `limit`, `offset`, `category`.

## Read a single skill

- [Skill JSON](https://www.skillopedia.ai/api/v1/skills/{slug}): full skill including metadata and content.
- [Skill revisions](https://www.skillopedia.ai/api/v1/skills/{slug}/revisions): version history, newest first, up to 50 entries.
- [Skill as markdown](https://www.skillopedia.ai/skills/{slug}.md): rendered as markdown with YAML frontmatter. Preferred for direct LLM consumption — `Content-Type: text/markdown`.
- [Skill as JSON](https://www.skillopedia.ai/skills/{slug}.json): same metadata as the `.md` variant plus the rendered markdown body.

## Authentication

- Read: no credentials needed.
- Write: bearer token via `Authorization: Bearer <token>` header. Token endpoint and OAuth metadata are listed in the agent manifest and at [`/.well-known/oauth-authorization-server`](https://www.skillopedia.ai/.well-known/oauth-authorization-server).

## Optional

- [Model Context Protocol endpoint](https://www.skillopedia.ai/mcp): MCP server for agent integration.
- [Source code](https://github.com/agentasticai/skillopedia): repository and issue tracker.