Docs Getting started
On this page
The localhost.md field guide

From discovery
to your workflow.

Find something useful. Understand what it does. Bring it into the way you work.

Open SKILL.md format Your choice of agent
Quick startDiscover → inspect → install

Your first skill, in three steps.

  1. 01

    Find your skill

    Explore the catalog by task, category, or agent.

  2. 02

    Look inside

    Read the instructions, requirements, and original source.

  3. 03

    Make it yours

    Choose your agent and run the install command.

Terminal
npx skills add https://github.com/vercel-labs/agent-skills/tree/063bee94c3f4df8453406c830b0a7df0f2860278/skills/react-best-practices --skill vercel-react-best-practices
Real example · pinned sourcevercel-react-best-practices
Use a skill

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.

Project Default
Install in the current project. A good place to start when a skill belongs to one codebase.
Global -g
Make the skill available across projects. Choose “Install for all your projects” on the skill page.
Give something back

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. 1

    Connect with GitHub

    Your GitHub account identifies you. Browse your public repositories or enter a repository manually.

  2. 2

    Choose the skill and its category

    Select a SKILL.md file, add useful tags, and declare the agents you want to list.

  3. 3

    Preview, then submit for review

    Check the imported metadata and source commit. A moderator reviews the submission before it becomes public.

SKILL.md
---
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.

Publish your skill
Keep it useful

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.

  1. Submit update
  2. Moderator review
  3. 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.

Build your collection

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.

Learn from experience

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.

Community rating
Feedback about this skill on localhost.md. Hidden and removed ratings do not affect the average. Reviews identify the source snapshot they were written for.
GitHub stars
Interest in the whole source repository. Counts are cached separately; the tooltip shows when they were checked. Unavailable counts are not shown as zero.
For your own tools

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
Example request
curl "https://localhost.md/api/v1/skills?q=testing&category=testing"
Supported query parameters
ParameterWhat it doesExample
qSearch by task or keywordtesting
categoryFilter by categorydevelopment
agentFilter declared agent targetscodex
viewShow curated listingsfeatured
sortShow newest listings firstnewest
pageChoose a results page2