vercel-labs/skills

▲ 4,576 stars today★ 37,095⑂ 3,192

The open agent skills tool - npx skills

About vercel-labs/skills

vercel-labs/skills is an open-source project on GitHub, mainly written in TypeScript. The open agent skills tool - npx skills It currently holds 37,095 stars and 3,192 forks with 1,205 open issues, and was last pushed on 2026-10-29 (repository created 2026-01-14).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository vercel-labs/skills · default branch main · size 1644 KB · watchers 122 · source: GitHub REST API and repository README

README

skills

The CLI for the open agent skills ecosystem.

Agent skills are reusable instructions that teach coding agents how to perform tasks, from reviewing code to working with a library. Discover skills at skills.sh.

Supports OpenCode, Claude Code, Codex, Cursor, and 75 more.

https://github.com/vercel-labs/skills/blob/HEAD/Vercel Labs Product https://github.com/vercel-labs/skills/blob/HEAD/npm version: skills https://github.com/vercel-labs/skills/blob/HEAD/License: MIT https://github.com/vercel-labs/skills/blob/HEAD/npm downloads per month: skills https://github.com/vercel-labs/skills/blob/HEAD/skills.sh

Install a Skill

Requires Node.js 22.20 or later. Run this from your project:

npx skills add vercel-labs/agent-skills

Choose the skills and coding agents to install to. Skills are installed to the current project by default; add -g to make them available across projects.

# Choose one skill and agent
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

Browse available skills

npx skills find

See the installation reference for source formats, private repositories, and all options.

Other Commands

| Command | Description | | --------------------------------- | -------------------------------- | | npx skills find [query] | Search for skills | | npx skills list | List installed skills | | npx skills use @ | Use one skill without installing | | npx skills check | Check for available updates | | npx skills update [skills...] | Update installed skills | | npx skills remove [skills...] | Remove installed skills | | npx skills init [name] | Create a skill template |

Read the CLI reference or run npx skills --help for examples and options. Experimental commands are listed below.

Use a Skill Without Installing

Generate a prompt for a skill, or launch a supported coding agent with it:

npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code

Omit --agent to print the prompt instead. See skills use.

Experimental Features

Commands prefixed with experimental_ are previews. Their names, options, and behavior may change or be removed in any release without notice.

| Command | Description | | --------------------------------- | --------------------------------------------------------- | | npx skills experimental_sync | Sync skills shipped by npm dependencies into your project | | npx skills experimental_install | Restore project skills recorded in skills-lock.json |

Some npm packages bundle instructions for your agent alongside their code. Sync links them into your project so they update with the dependency, and also installs skill packs declared in package.json:

npm install -D skills agent-browser
npx skills experimental_sync -y

See the experimental commands reference for options, the skills field, and the RFC behind it.

Lock File Content Hash

skills-lock.json (version 2) records a computedHash for each project skill. The hash covers the files the CLI installs into .agents/skills/, so list, check, and install --frozen-lockfile can compare it with what is on disk. Tools that check skills themselves can compute the same value:

1. Collect every file in the skill folder. Leave out metadata.json files and the .git, __pycache__, and __pypackages__ folders, because the installer does not copy them. A symlink counts as the file or folder it points to. Leave out a symlink that is broken, loops, or points outside the skill folder. 2. Give each file a path relative to the skill folder, with / as the separator. 3. For a text file (a file that contains no NUL byte), replace each CRLF with LF. Do not change binary files. 4. Sort the files by the UTF-8 bytes of their paths. Do not use a locale-aware sort. 5. For each file in that order, feed path, a NUL byte, the content length in bytes as decimal ASCII, a NUL byte, and the content into one SHA-256. The content length is counted after step 3. 6. The hash is the lowercase hex digest.

Test vectors:

| Files | computedHash | | -------------------------------------------- | ------------------------------------------------------------------ | | none | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 | | SKILL.md = # hi\n | 93c36952d8843b33e68ae970ebabcc03e1687c9bb0dd1ecaf357060318952f55 | | SKILL.md = a\n, docs/b.md = b\n | b22c4d22aa319d2924312fa18fcbfedc88fa89c74dbd8f298c683e1caf7b7f24 |

The last vector equals printf 'SKILL.md\0002\000a\ndocs/b.md\0002\000b\n' | sha256sum.

For a Git source, the entry also records the commit the skill came from. skills install (with or without --frozen-lockfile) fetches that commit, not the latest commit on ref, so a restore still matches computedHash after the source repository changes. skills update moves commit forward, and it adds a commit to an older entry that has none. The server must allow fetching a commit by its SHA. GitHub and GitLab allow this.

A skill installed with --rename is hashed as it is installed: its SKILL.md has the new name in the frontmatter, so the hash differs from the upstream folder's hash.

A version 1 lock is upgraded when it is read, without network access. An installed skill whose files still match its version 1 hash gets a new hash computed from those files. Any other entry gets an empty hash, because there is nothing trusted to check it against. skills install fetches those skills again and records new hashes, and --frozen-lockfile fails until that is done.

Supported Agents

The CLI detects installed agents and lets you choose where skills are installed. See all supported agents, installation paths, and compatibility.

Creating Skills

npx skills init my-skill

Edit the generated SKILL.md with instructions for your agent. See creating and sharing skills for the format and discovery rules.

Documentation

Telemetry

The CLI collects anonymous usage data. Set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 to disable telemetry and security-audit requests. See what is collected.

Related Links

License

This project is licensed under the MIT License.

GitHub Stars & Activity

37,095Stars
3,192Forks
1,205Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars37,095
Forks3,192
Open issues1,205
Primary languageTypeScript
LicenseMIT
Stars gained today4,576
Created2026-01-14
Last pushed2026-10-29

Trending History

Monthly boardrank #56 · ▲ 4,576 stars

Related GitHub Projects

1

stablyai / orca

TypeScript★ 127,260⑂ 8,075▲ 1,052 stars
→
2

ChromeDevTools / chrome-devtools-mcp

TypeScript★ 57,914⑂ 4,863▲ 841 stars
→
3

tashfeenahmed / freellmapi

TypeScript★ 53,735⑂ 7,551▲ 649 stars
→
4

dream-num / univer

TypeScript★ 28,626⑂ 2,606▲ 1,828 stars
→
5

milind-soni / OpenMausBot

TypeScript★ 24,497⑂ 3,418▲ 662 stars
→
6

ag-ui-protocol / ag-ui

TypeScript★ 19,726⑂ 2,037▲ 791 stars
→
7

cursor / plugins

TypeScript★ 16,722⑂ 1,787▲ 196 stars
→
8

backnotprop / plannotator

TypeScript★ 12,862⑂ 1,287▲ 696 stars
→

More Trending Repositories