From discovery
to your workflow.
Find something useful. Understand what it does. Bring it into the way you work.
Your first skill, in three steps.
- 01
Find your skill
Explore the catalog by task, category, or agent.
- 02
Look inside
Read the instructions, requirements, and original source.
- 03
Make it yours
Choose your agent and run the install command.
npx skills add https://github.com/vercel-labs/agent-skills/tree/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices --skill vercel-react-best-practices
Install a skill
Open a skill page, read its instructions and source, then choose an agent and copy the install command into your terminal. The current skills CLI requires Node.js 22.20 or newer.
Publish your skill
A useful workflow deserves to be discovered. Keep your source in a public GitHub repository and give people clear instructions for when and how to use it.
- 1
Connect with GitHub
Your GitHub account identifies you. Browse your public repositories or enter a repository manually.
- 2
Choose the skill and its category
Select a
SKILL.mdfile, add useful tags, and declare the agents you want to list. - 3
Preview, then submit for review
Check the imported metadata and source commit. A moderator reviews the submission before it becomes public.
---
name: code-review
description: Review code for clarity and correctness.
---
# Code review
1. Read the relevant code and project conventions.
2. Check correctness, edge cases, and tests.
3. Explain findings with file references.
Use a regular UTF-8 SKILL.md file, up to 64 KiB, with a YAML name and description followed by instructions. We read the source without executing it. The installer reads the complete upstream skill directory, including supporting scripts and assets.
Update a listing
The original submitter or a moderator can import the same repository and path again. Your current public snapshot stays available while the new version is reviewed.
- Submit update
- Moderator review
- Approved snapshot
Approved commits enter the source history. Follow submission status and moderator notes on your publishing page. Imports are manual; changes to the upstream branch are not automatically synchronized.
Discover & save
Search for what you want to do. Results match the skill’s name, description, source, category, and tags. Combine search with category and agent filters to narrow things down.
Sign in to save skills to your private collection. Agent targets are declared by submitters, so check the source’s actual requirements before you install.
Ratings & reviews
Sign in with GitHub to leave a 1–5 star rating and an optional review. Each account has one rating per skill, which can be edited or removed. Submitters and repository owners cannot rate their own skill.
Public API
Read public listing metadata, source commits, and install commands from your own tools. Responses are paginated and use the same filters as the catalog.
GET/api/v1/skills
curl "https://localhost.md/api/v1/skills?q=testing&category=testing"
| Parameter | What it does | Example |
|---|---|---|
q | Search by task or keyword | testing |
category | Filter by category | development |
agent | Filter declared agent targets | codex |
view | Show curated listings | featured |
sort | Show newest listings first | newest |
page | Choose a results page | 2 |