MCP server
The skilld MCP server lets ChatGPT, Claude, and other MCP apps search and browse the registry. It needs no account. Every tool reads the registry, except Submit a repository, which asks skilld.dev to index a public GitHub repository.
https://skilld.dev/api/mcp- It returns Skills with their author and their source on GitHub.
- It returns run and install commands as text. You run them. The server runs and installs nothing.
- It does not check whether a Skill is safe. Read a Skill before you run it.
Tools
The text under each tool is the description your app reads.
Search Skills
search_skillsRead onlySearch the skilld.dev registry for agent skills that match a topic. A skill is a SKILL.md file that a maintainer publishes in their own GitHub repository, and it works with any coding agent. Returns each match with its source repository, GitHub star count, skilld.dev page, and run command.
Find a skill for Tailwind CSS.Get Skill details
get_skillRead onlyLook up one skill by GitHub owner, repository, and skill name. Returns its provenance: the publisher, the exact SKILL.md file and commit on GitHub, and freshness (the last repository push and the last skill change). Also returns the full SKILL.md text, the skilld.dev page, runCommand, and installCommand. runCommand gives the skill to a coding agent for one session and writes no files. installCommand writes the skill into the project for every session. files lists the files beside SKILL.md without their contents. behaviors lists what SKILL.md and the file names ask an agent to do; a behavior with tier ask is one that skilld run holds for the user's approval. skilld does not check whether a skill is safe.
Who wrote vercel-labs/agent-skills/web-design-guidelines, and when did it last change?Get run and install commands
install_commandRead onlyReturn the exact skilld CLI commands for a skill or a repository ref. For a single skill, runCommand gives the skill to a coding agent for one session and writes no files. command installs the skills into the project. Accepted refs: "owner/repo", "owner/repo/skill-name". This tool returns text only. It runs and installs nothing.
Give me the command to try anthropics/skills/skill-creator without installing it.List tracks
list_tracksRead onlyList skilld's tracks. A track is a page of Skills for one kind of work a developer wants done, such as testing and debugging, planning and specs, or design and interface work. A person picks its first Skills, and a classifier adds the rest. Returns each track's slug, label, the goal it serves, its skilld.dev page, and its Skill count.
What kinds of work does skilld have Skills for?Get track
get_trackRead onlyGet the Skills in one track, the page of Skills for one kind of work, such as testing or design. Takes the track slug. Returns the track's label, its goal line, its skilld.dev page, and its Skills in page order: the hand-picked Skills first, then the rest by GitHub stars. Each Skill has its GitHub owner and repository, its skilld.dev page, and its run command. total counts every Skill in the track, and limit and offset page through them.
Which skills help with testing and debugging?List trending Skills
list_trendingRead onlySee which Skills developers talked about recently. Returns the skilld.dev trending board for the past week or month, in rank order. Each row says why it is on the board: a social row counts the devs and the public X and Bluesky posts that mentioned the Skill and links one post, a star-surge row counts new GitHub stars, and a star-count row fills the rest of the board. Each row has its GitHub owner and repository, its skilld.dev page, and its run command.
What skills are developers talking about this week?Get repository
get_repositoryRead onlySee every Skill that one GitHub repository publishes. Takes the owner and the repository name. Returns the repository's description, GitHub star count, last push, skilld.dev page, and the command that installs all of its Skills. Its Skills come most recently changed first, each with its skilld.dev page and run command. total counts every Skill in the repository.
Which skills does vercel-labs/agent-skills publish?Submit a repository
submit_repositoryQueues a requestAsk skilld.dev to index the Skills in a public GitHub repository. Takes owner/repo or a GitHub URL. If the registry already holds Skills from the repository, returns status indexed with its Skill count and the repository's skilld.dev page. Otherwise it queues an index request and returns status queued, its id, and a status URL. The status URL reports progress, or the reason the request failed, such as a private or missing repository. A second request for a queued repository returns the same id. A person still reviews which Skills the registry admits. This changes nothing in the repository.
Add github.com/vercel-labs/agent-skills to skilld.
Connect
In Claude, select Add to Claude above. Claude opens the Add custom connector dialog with skilld filled in. Select Continue, keep No sign-in, and select Add. Then select Connect.
ChatGPT, Codex, Cursor, VS Code, and other MCP apps each have their own steps. Open the setup steps for each app .
Limits and data
- Every tool is read only, except Submit a repository. It queues an index request and changes nothing in the repository. The server sets no cookie.
- Each search or lookup counts against a limit of 60 requests a minute per IP address. ChatGPT and Claude call from their own servers, so their users share that allowance.
- Each tool receives only its inputs, such as your search text or a Skill name. It receives no chat history and no files.
The privacy page lists what each tool receives. The terms cover the MCP server.
Troubleshooting
- Origin not allowed (HTTP 403)
- The server accepts browser requests from skilld.dev, Claude, and ChatGPT only. Apps that call from a server or from your computer send no Origin and connect as usual. If a browser app you use gets this error, contact support below.
- Too many requests
- The rate limit is spent. Wait 60 seconds, then try again.
- Claude says you are not connected to skilld yet
- Claude adds a connector and connects it in two steps. Open Customize, then Connectors, select skilld, and select Connect.
Support
Email harlan@harlanzw.com, or ask in the Harlan's Open Source Discord.