Skip to content
Back to search

skills

The open agent skills tool - npx skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vercel-labs/skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vercel-labs/skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vercel-labs-skills/badge.svg)](/listings/vercel-labs-skills)

HTML

<a href="/listings/vercel-labs-skills"><img src="/api/listings/vercel-labs-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add vercel-labs/agent-skills

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 150 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # skills
  2. The CLI for the open agent skills ecosystem.
  3. Agent skills are reusable instructions that teach coding agents how to perform tasks,
  4. from reviewing code to working with a library. Discover skills at [skills.sh](https://skills.sh).
  5. <!-- agent-list:start -->
  6. Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [75 more](docs/agents.md).
  7. <!-- agent-list:end -->
  8. <p>
  9. <a href="https://vercel.com/labs#labs-products"><img alt="Vercel Labs Product" src="https://img.shields.io/badge/LABS-PRODUCT-0a0a0a.svg?style=for-the-badge&amp;logo=Vercel&amp;labelColor=000000" height="28"></a>
  10. <a href="https://www.npmjs.com/package/skills"><img alt="npm version: skills" src="https://img.shields.io/npm/v/skills.svg?style=for-the-badge&amp;labelColor=000000" height="28"></a>
  11. <a href="https://github.com/vercel-labs/skills/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/github/license/vercel-labs/skills.svg?style=for-the-badge&amp;labelColor=000000" height="28"></a>
  12. <a href="https://www.npmjs.com/package/skills"><img alt="npm downloads per month: skills" src="https://img.shields.io/npm/dm/skills.svg?style=for-the-badge&amp;labelColor=000000&amp;label=npm%20downloads" height="28"></a>
  13. <a href="https://skills.sh/vercel-labs/skills"><img alt="skills.sh" src="https://skills.sh/b/vercel-labs/skills?style=for-the-badge" height="28"></a>
  14. </p>
  15. ## Install a Skill
  16. Requires Node.js 22.20 or later. Run this from your project:
  17. ```bash
  18. npx skills add vercel-labs/agent-skills
  19. ```
  20. Choose the skills and coding agents to install to. Skills are installed to the current
  21. project by default; add `-g` to make them available across projects.
  22. ```bash
  23. # Choose one skill and agent
  24. npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
  25. # Browse available skills
  26. npx skills find
  27. ```
  28. See the [installation reference](docs/commands.md#skills-add) for source formats,
  29. private repositories, and all options.
  30. ## Other Commands
  31. | Command | Description |
  32. | --------------------------------- | -------------------------------- |
  33. | `npx skills find [query]` | Search for skills |
  34. | `npx skills list` | List installed skills |
  35. | `npx skills use <source>@<skill>` | Use one skill without installing |
  36. | `npx skills check` | Check for available updates |
  37. | `npx skills update [skills...]` | Update installed skills |
  38. | `npx skills remove [skills...]` | Remove installed skills |
  39. | `npx skills init [name]` | Create a skill template |
  40. Read the [CLI reference](docs/commands.md) or run `npx skills --help` for examples and options. Experimental commands are listed [below](#experimental-features).
  41. ## Use a Skill Without Installing
  42. Generate a prompt for a skill, or launch a supported coding agent with it:
  43. ```bash
  44. npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code
  45. ```
  46. Omit `--agent` to print the prompt instead. See [`skills use`](docs/commands.md#skills-use).
  47. ## Experimental Features
  48. <details>
  49. <summary>Commands prefixed with <code>experimental_</code> are previews. Their names, options, and behavior may change or be removed in any release without notice.</summary>
  50. | Command | Description |
  51. | --------------------------------- | --------------------------------------------------------- |
  52. | `npx skills experimental_sync` | Sync skills shipped by npm dependencies into your project |
  53. | `npx skills experimental_install` | Restore project skills recorded in `skills-lock.json` |
  54. 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`:
  55. ```bash
  56. npm install -D skills agent-browser
  57. npx skills experimental_sync -y
  58. ```
  59. See the [experimental commands reference](docs/commands.md#experimental-commands) for options, the `skills` field, and the [RFC](https://github.com/vercel-labs/skills/issues/2323) behind it.
  60. </details>
  61. ## Lock File Content Hash
  62. `skills-lock.json` (version 2) records a `computedHash` for each project skill. The hash covers the files the CLI installs into `.agents/skills/<name>`, 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:
  63. 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.
  64. 2. Give each file a path relative to the skill folder, with `/` as the separator.
  65. 3. For a text file (a file that contains no NUL byte), replace each CRLF with LF. Do not change binary files.
  66. 4. Sort the files by the UTF-8 bytes of their paths. Do not use a locale-aware sort.
  67. 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.
  68. 6. The hash is the lowercase hex digest.
  69. Test vectors:
  70. | Files | `computedHash` |
  71. | -------------------------------------------- | ------------------------------------------------------------------ |
  72. | none | `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855` |
  73. | `SKILL.md` = `# hi\n` | `93c36952d8843b33e68ae970ebabcc03e1687c9bb0dd1ecaf357060318952f55` |
  74. | `SKILL.md` = `a\n`, `docs/b.md` = `b\n` | `b22c4d22aa319d2924312fa18fcbfedc88fa89c74dbd8f298c683e1caf7b7f24` |
  75. The last vector equals `printf 'SKILL.md\0002\000a\ndocs/b.md\0002\000b\n' | sha256sum`.
  76. 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.
  77. 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.
  78. 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.
  79. ## Supported Agents
  80. The CLI detects installed agents and lets you choose where skills are installed.
  81. See [all supported agents, installation paths, and compatibility](docs/agents.md).
  82. ## Creating Skills
  83. ```bash
  84. npx skills init my-skill
  85. ```
  86. Edit the generated `SKILL.md` with instructions for your agent.
  87. See [creating and sharing skills](docs/creating-skills.md) for the format and discovery rules.
  88. ## Documentation
  89. - [CLI reference](docs/commands.md): installation, command examples, and experimental features
  90. - [Supported agents](docs/agents.md): agent names, skill directories, and compatibility
  91. - [Creating skills](docs/creating-skills.md): frontmatter, repository layouts, and plugins
  92. - [Troubleshooting and configuration](docs/troubleshooting.md): common problems, environment variables, and telemetry
  93. - [Programmatic API](docs/api.md): install and manage skills from your own tools with `import { installSkills } from 'skills'`
  94. ## Telemetry
  95. The CLI collects anonymous usage data. Set `DISABLE_TELEMETRY=1` or `DO_NOT_TRACK=1`
  96. to disable telemetry and security-audit requests.
  97. See [what is collected](docs/troubleshooting.md#telemetry).
  98. ## Related Links
  99. - [Skills Directory](https://skills.sh)
  100. - [Agent Skills Specification](https://agentskills.io)
  101. - [Vercel Agent Skills](https://github.com/vercel-labs/agent-skills)
  102. ## License
  103. This project is licensed under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.