The open agent skills tool - npx skills

★ 39,488⑂ 3,475👁 132⑃ 1,054● 1,680▤ 55
TypeScriptMITCreated 2026-01-14skills.sh
Download: v1.8.1skills-1.8.1 ↓1.8.12026-11-10
+133
Daily
+809
Weekly
+5,495
Monthly
39,488
stars
3,475
forks
132
watchers
1,054
prs
1,680
issues
55
releases

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.



  
  
  
  
  


 Install a Skill

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

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

bash
 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:

bash
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:

bash
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 com

Top issues

Latest release

v1.8.1 v1.8.1 2026-11-10
Changelog

- fix: restore the CLI subpath export (2734)
- chore(deps): update all dependencies (2732)
- fix(find): fall back to partial matches for multi-term queries (2731)

 Contributors

@antfubot,@quuu @rexxars

News & coverage (20)

Hacker NewsShow HN: Skill that lets Claude Code/Codex spin up VMs and GPUs▲ 138 · 36 comments · 2026-02-13Hacker NewsShow HN: Skillful, stop maintaining the same AI workflow in five places▲ 2 · 0 comments · 2026-07-16Hacker NewsShow HN: Skills-CLI, Sync local and remote skills with agentic IDEs▲ 1 · 0 comments · 2026-01-16Blockchain Newsanthropics/skills Gains 1,676 Stars in 24 Hours on GitHub Trending2026-11-10noteSyncing multiple AI agent skills with one npx skills command — Read 18 out of 18 times by Claude Code, Codex, and OpenCode2026-11-09noteWhere do Claude Code, Codex, and OpenCode read skills from? — A diagram of how npx skills add lets all three read the same skill at once2026-11-09Unite.AICloudsmith Puts AI Agent Skills Under Artifact Registry Controls2026-11-09note2026-11-08 GitHub Top 10: The Day Four 'skills' Repositories Line Up2026-11-08devblogsDelivering Skills in NuGet packages2026-11-03The Indian Express‘We see more developers building and pushing way more projects’: GitHub COO Kyle Daigle2026-10-29
10 moreVisual Studio MagazineGitHub Copilot Usage Metrics Now Identify Custom Skills, Agents and MCP Servers2026-10-27Visual Studio MagazineMicrosoft Opens GitHub-Built Copilot Harness to Developers Through Foundry2026-10-27i-SCOOPAgent Skills gets a neutral home, and your organisation’s know-how becomes portable2026-10-24Visual Studio MagazineHands On with New Experimental GitHub Copilot 'Agent Skills' in VS Code2026-01-10githubGitHub Copilot now supports Agent Skills2025-12-18The RegisterMicrosoft admits certifications can be a drag, launches creds that recognize skills2026-11-05KDnuggets5 Best GitHub Repositories for AI Agent Skills2026-10-21MicrosoftNew and improved: GitHub Copilot harness, agent skills, and richer context2026-09-02The GitHub BlogCopilot code review: Agent skills and MCP now generally available2026-07-29Google CloudLevel Up Your Agents: Announcing Google's Official Skills Repository2026-04-22

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON