New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details
Socket
Book a DemoSign in
Socket

equip-skill

Package Overview
Dependencies
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

equip-skill

Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)

latest
Source
npmnpm
Version
1.0.25
Version published
Maintainers
1
Created
Source

equip-skill

A fork of vercel-labs/add-skill designed for direct, clean skill installation.

Install agent skills directly to your project without intermediate caches or symlinks. Perfect for single-agent workflows like Antigravity.

Supports Antigravity, Opencode, Claude Code, Codex, Cursor, and 12 more.

Quick Start

npx equip-skill vercel-labs/agent-skills

What are Agent Skills?

Agent skills are reusable instruction sets that extend your coding agent's capabilities. They're defined in SKILL.md files with YAML frontmatter containing a name and description.

Skills let agents perform specialized tasks like:

  • Generating release notes from git history
  • Creating PRs following your team's conventions
  • Integrating with external tools (Linear, Notion, etc.)

Usage

Source Formats

The <source> argument accepts multiple formats:

# GitHub shorthand
npx equip-skill vercel-labs/agent-skills

# Full GitHub URL
npx equip-skill https://github.com/vercel-labs/agent-skills

# Direct path to a skill in a repo
npx equip-skill https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design

# GitLab URL
npx equip-skill https://gitlab.com/org/repo

# Any git URL
npx equip-skill git@github.com:vercel-labs/agent-skills.git

Options

OptionDescription
-g, --globalInstall to user directory instead of project
-a, --agent <agents...>Target specific agents (e.g., claude-code, codex). See Available Agents
-s, --skill <skills...>Install specific skills by name
-l, --listList available skills without installing
-y, --yesSkip all confirmation prompts
-V, --versionShow version number
-h, --helpShow help

Examples

# List skills in a repository
npx equip-skill vercel-labs/agent-skills --list

# Install multiple specific skills
npx equip-skill vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# Install to specific agents
npx equip-skill vercel-labs/agent-skills -a claude-code -a opencode

# Non-interactive installation (CI/CD friendly)
npx equip-skill vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# Install all skills from a repo
npx equip-skill vercel-labs/agent-skills -y -g

Available Agents

Skills can be installed to any of these supported agents. Use -g, --global to install to the global path instead of project-level.

Agent--agentProject PathGlobal Path
Ampamp.agents/skills/~/.config/agents/skills/
Antigravityantigravity.agent/skills/~/.gemini/antigravity/skills/
Claude Codeclaude-code.claude/skills/~/.claude/skills/
Clawdbotclawdbotskills/~/.clawdbot/skills/
Codexcodex.codex/skills/~/.codex/skills/
Cursorcursor.cursor/skills/~/.cursor/skills/
Droiddroid.factory/skills/~/.factory/skills/
Gemini CLIgemini-cli.gemini/skills/~/.gemini/skills/
GitHub Copilotgithub-copilot.github/skills/~/.copilot/skills/
Goosegoose.goose/skills/~/.config/goose/skills/
Kilo Codekilo.kilocode/skills/~/.kilocode/skills/
Kiro CLIkiro-cli.kiro/skills/~/.kiro/skills/
OpenCodeopencode.opencode/skills/~/.config/opencode/skills/
Roo Coderoo.roo/skills/~/.roo/skills/
Traetrae.trae/skills/~/.trae/skills/
Windsurfwindsurf.windsurf/skills/~/.codeium/windsurf/skills/

[!NOTE] Kiro CLI users: After installing skills, you need to manually add them to your custom agent's resources in .kiro/agents/<agent>.json:

{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

Agent Detection

The CLI automatically detects which coding agents you have installed by checking for their configuration directories. If none are detected, you'll be prompted to select which agents to install to.

Creating Skills

Skills are directories containing a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: What this skill does and when to use it
---

# My Skill

Instructions for the agent to follow when this skill is activated.

## When to Use

Describe the scenarios where this skill should be used.

## Steps

1. First, do this
2. Then, do that

Required Fields

  • name: Unique identifier (lowercase, hyphens allowed)
  • description: Brief explanation of what the skill does

Skill Discovery

The CLI searches for skills in these locations within a repository:

  • Root directory (if it contains SKILL.md)
  • skills/
  • skills/.curated/
  • skills/.experimental/
  • skills/.system/
  • .agents/skills/
  • .agent/skills/
  • .claude/skills/
  • ./skills/
  • .codex/skills/
  • .cursor/skills/
  • .factory/skills/
  • .gemini/skills/
  • .github/skills/
  • .goose/skills/
  • .kilocode/skills/
  • .kiro/skills/
  • .opencode/skills/
  • .roo/skills/
  • .trae/skills/
  • .windsurf/skills/

If no skills are found in standard locations, a recursive search is performed.

Compatibility

Skills are generally compatible across agents since they follow a shared Agent Skills specification. However, some features may be agent-specific:

FeatureOpenCodeClaude CodeCodexKiro CLICursorAntigravityRoo CodeGithub CopilotAmpClawdbot
Basic skillsYesYesYesYesYesYesYesYesYesYes
allowed-toolsYesYesYesNoYesYesYesYesYesYes
context: forkNoYesNoNoNoNoNoNoNoNo
HooksNoYesNoNoNoNoNoNoNoNo

Troubleshooting

"No skills found"

Ensure the repository contains valid SKILL.md files with both name and description in the frontmatter.

Skill not loading in agent

  • Verify the skill was installed to the correct path
  • Check the agent's documentation for skill loading requirements
  • Ensure the SKILL.md frontmatter is valid YAML

Permission errors

Ensure you have write access to the target directory.

Telemetry

This CLI collects anonymous usage data to help improve the tool. No personal information is collected.

To disable telemetry, set either of these environment variables:

DISABLE_TELEMETRY=1 npx equip-skill vercel-labs/agent-skills
# or
DO_NOT_TRACK=1 npx equip-skill vercel-labs/agent-skills

Telemetry is also automatically disabled in CI environments.

License

MIT

Keywords

cli

FAQs

Package last updated on 21 Jan 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts