JSPM

@alexsun-top/skills

1.4.6
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 122
  • Score
    100M100P100Q87857F
  • License MIT

The open agent skills ecosystem (Fork of npx skills by alexsun-top)

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@alexsun-top/skills) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @alexsun-top/skills

    ⚠️ This is a Fork

    This is a fork of npx @alexsun-top/skills, maintained by alexsun-top. The original project was developed by Vercel Labs.

    The CLI for the open agent skills ecosystem.

    # Using npm
npm i -g @alexsun-top/skills

# Using pnpm
pnpm i -g @alexsun-top/skills

    After installation, you can use the skills command directly without typing npx every time.

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

    Install a Skill

    npx @alexsun-top/skills add vercel-labs/agent-skills

    Source Formats

    # GitHub shorthand (owner/repo)
npx @alexsun-top/skills add vercel-labs/agent-skills

# Full GitHub URL
npx @alexsun-top/skills add https://github.com/vercel-labs/agent-skills

# Direct path to a skill in a repo
npx @alexsun-top/skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab URL
npx @alexsun-top/skills add https://gitlab.com/org/repo

# Any git URL
npx @alexsun-top/skills add git@github.com:vercel-labs/agent-skills.git

# Any HTTPS git URL with explicit ref
npx @alexsun-top/skills add https://git.example.com/team/skill-pack.git@release-2026

# GitHub URL with explicit tag/branch/commit ref
npx @alexsun-top/skills add https://github.com/user/skills.git@v1.2.3

# Any SSH git URL with explicit ref
npx @alexsun-top/skills add git@git.example.com:team/skill-pack.git@main

# Local path
npx @alexsun-top/skills add ./my-local-skills

    Options

    Option Description
    -g, --global Install 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 (use '*' for all skills)
    -l, --list List available skills without installing
    --copy Copy files instead of symlinking to agent directories
    -y, --yes Skip all confirmation prompts
    --all Install all skills to all agents without prompts

    Examples

    # List skills in a repository
npx @alexsun-top/skills add vercel-labs/agent-skills --list

# Install specific skills
npx @alexsun-top/skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# Install a skill with spaces in the name (must be quoted)
npx @alexsun-top/skills add owner/repo --skill "Convex Best Practices"

# Install to specific agents
npx @alexsun-top/skills add vercel-labs/agent-skills -a claude-code -a opencode

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

# Install all skills from a repo to all agents
npx @alexsun-top/skills add vercel-labs/agent-skills --all

# Install all skills to specific agents
npx @alexsun-top/skills add vercel-labs/agent-skills --skill '*' -a claude-code

# Install specific skills to all agents
npx @alexsun-top/skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

    Installation Scope

    Scope Flag Location Use Case
    Project (default) ./<agent>/skills/ Committed with your project, shared with team
    Global -g ~/<agent>/skills/ Available across all projects

    Installation Methods

    When installing interactively, you can choose:

    Method Description
    Symlink (Recommended) Creates symlinks from each agent to a canonical copy. Single source of truth, easy updates.
    Copy Creates independent copies for each agent. Use when symlinks aren't supported.

    Other Commands

    Command Description
    npx @alexsun-top/skills list List installed skills (alias: ls)
    npx @alexsun-top/skills find [query] Search for skills interactively or by keyword
    npx @alexsun-top/skills remove [skills] Remove installed skills from agents
    npx @alexsun-top/skills check Check for available skill updates
    npx @alexsun-top/skills update Update all installed skills to latest versions
    npx @alexsun-top/skills init [name] Create a new SKILL.md template
    npx @alexsun-top/skills config <command> Manage configuration settings

    skills list

    List all installed skills. Similar to npm ls.

    # List all installed skills (project and global)
npx @alexsun-top/skills list

# List only global skills
npx @alexsun-top/skills ls -g

# Filter by specific agents
npx @alexsun-top/skills ls -a claude-code -a cursor

    skills find

    Search for skills interactively or by keyword.

    # Interactive search (fzf-style)
npx @alexsun-top/skills find

# Search by keyword
npx @alexsun-top/skills find typescript

    skills check / skills update

    # Check if any installed skills have updates
npx @alexsun-top/skills check

# Update all skills to latest versions
npx @alexsun-top/skills update

    skills init

    # Create SKILL.md in current directory
npx @alexsun-top/skills init

# Create a new skill in a subdirectory
npx @alexsun-top/skills init my-skill

    skills install

    Install skills from the skills-lock.json file. This ensures your local skills match the lock file exactly.

    # Install all skills from skills-lock.json
npx @alexsun-top/skills install

# Install specific skills
npx @alexsun-top/skills install my-skill

# Preview changes without applying
npx @alexsun-top/skills install --dry-run

# Force reinstallation of all skills
npx @alexsun-top/skills install --force

# Install without confirmation prompts
npx @alexsun-top/skills install -y

# Install global skills
npx @alexsun-top/skills install -g

    Note: skills sync is deprecated. Use skills install instead.

    skills remove

    Remove installed skills from agents.

    # Remove interactively (select from installed skills)
npx @alexsun-top/skills remove

# Remove specific skill by name
npx @alexsun-top/skills remove web-design-guidelines

# Remove multiple skills
npx @alexsun-top/skills remove frontend-design web-design-guidelines

# Remove from global scope
npx @alexsun-top/skills remove --global web-design-guidelines

# Remove from specific agents only
npx @alexsun-top/skills remove --agent claude-code cursor my-skill

# Remove all installed skills without confirmation
npx @alexsun-top/skills remove --all

# Remove all skills from a specific agent
npx @alexsun-top/skills remove --skill '*' -a cursor

# Remove a specific skill from all agents
npx @alexsun-top/skills remove my-skill --agent '*'

# Use 'rm' alias
npx @alexsun-top/skills rm my-skill
    Option Description
    -g, --global Remove from global scope (~/) instead of project
    -a, --agent Remove from specific agents (use '*' for all)
    -s, --skill Specify skills to remove (use '*' for all)
    -y, --yes Skip confirmation prompts
    --all Shorthand for --skill '*' --agent '*' -y

    skills config

    Manage skills CLI configuration settings.

    # Get a config value
npx @alexsun-top/skills config get registry

# Set a config value
npx @alexsun-top/skills config set registry https://my-registry.com

# List all config values with their sources
npx @alexsun-top/skills config list

# Remove a config value (revert to default)
npx @alexsun-top/skills config unset timeout

    Configuration Keys

    Key Description Default Environment Variable
    registry Default registry URL for skill discovery https://skills.sh/ SKILLS_REGISTRY
    update-registry Registry URL for skill update checking service https://add-skill.vercel.sh SKILLS_UPDATE_REGISTRY
    timeout Default timeout for network operations (seconds) 30 SKILLS_TIMEOUT
    telemetry Enable/disable anonymous usage telemetry true SKILLS_TELEMETRY

    Priority

    Configuration values are resolved in this priority order:

    1. Environment variables (highest priority)
    2. Config file (~/.config/skills/config.json or %LOCALAPPDATA%\skills\config.json)
    3. Default values (lowest priority)

    Config File Location

    • Linux/macOS: ~/.config/skills/config.json (or $XDG_CONFIG_HOME/skills/config.json if set)
    • Windows: %LOCALAPPDATA%\skills\config.json

    Examples

    # Set a custom registry
npx @alexsun-top/skills config set registry https://my-company.com/skills

# Set timeout to 60 seconds
npx @alexsun-top/skills config set timeout 60

# Disable telemetry
npx @alexsun-top/skills config set telemetry false

# Get current registry (shows effective value considering env vars)
npx @alexsun-top/skills config get registry

# Show all config values with their sources
npx @alexsun-top/skills config list

# Remove custom registry (revert to default)
npx @alexsun-top/skills config unset registry

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

    Discover skills at skills.sh

    Supported Agents

    Skills can be installed to any of these agents:

    Agent --agent Project Path Global Path
    Amp, Kimi Code CLI, Replit, Universal amp, kimi-cli, replit, universal .agents/skills/ ~/.config/agents/skills/
    Antigravity antigravity .agent/skills/ ~/.gemini/antigravity/skills/
    Augment augment .augment/skills/ ~/.augment/skills/
    Claude Code claude-code .claude/skills/ ~/.claude/skills/
    OpenClaw openclaw skills/ ~/.openclaw/skills/
    Cline cline .cline/skills/ ~/.cline/skills/
    CodeBuddy codebuddy .codebuddy/skills/ ~/.codebuddy/skills/
    Codex codex .agents/skills/ ~/.codex/skills/
    Command Code command-code .commandcode/skills/ ~/.commandcode/skills/
    Continue continue .continue/skills/ ~/.continue/skills/
    Cortex Code cortex .cortex/skills/ ~/.snowflake/cortex/skills/
    Crush crush .crush/skills/ ~/.config/crush/skills/
    Cursor cursor .agents/skills/ ~/.cursor/skills/
    Droid droid .factory/skills/ ~/.factory/skills/
    Gemini CLI gemini-cli .agents/skills/ ~/.gemini/skills/
    GitHub Copilot github-copilot .agents/skills/ ~/.copilot/skills/
    Goose goose .goose/skills/ ~/.config/goose/skills/
    Junie junie .junie/skills/ ~/.junie/skills/
    iFlow CLI iflow-cli .iflow/skills/ ~/.iflow/skills/
    Kilo Code kilo .kilocode/skills/ ~/.kilocode/skills/
    Kiro CLI kiro-cli .kiro/skills/ ~/.kiro/skills/
    Kode kode .kode/skills/ ~/.kode/skills/
    MCPJam mcpjam .mcpjam/skills/ ~/.mcpjam/skills/
    Mistral Vibe mistral-vibe .vibe/skills/ ~/.vibe/skills/
    Mux mux .mux/skills/ ~/.mux/skills/
    OpenCode opencode .agents/skills/ ~/.config/opencode/skills/
    OpenHands openhands .openhands/skills/ ~/.openhands/skills/
    Pi pi .pi/skills/ ~/.pi/agent/skills/
    Qoder qoder .qoder/skills/ ~/.qoder/skills/
    Qwen Code qwen-code .qwen/skills/ ~/.qwen/skills/
    Roo Code roo .roo/skills/ ~/.roo/skills/
    Trae trae .trae/skills/ ~/.trae/skills/
    Trae CN trae-cn .trae/skills/ ~/.trae-cn/skills/
    Windsurf windsurf .windsurf/skills/ ~/.codeium/windsurf/skills/
    Zencoder zencoder .zencoder/skills/ ~/.zencoder/skills/
    Neovate neovate .neovate/skills/ ~/.neovate/skills/
    Pochi pochi .pochi/skills/ ~/.pochi/skills/
    AdaL adal .adal/skills/ ~/.adal/skills/

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

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

    The CLI automatically detects which coding agents you have installed. 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

    Optional Fields

    • metadata.internal: Set to true to hide the skill from normal discovery. Internal skills are only visible and installable when INSTALL_INTERNAL_SKILLS=1 is set. Useful for work-in-progress skills or skills meant only for internal tooling.
    ---
name: my-internal-skill
description: An internal skill not shown by default
metadata:
  internal: true
---

    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/
    • .augment/skills/
    • .claude/skills/
    • ./skills/
    • .cline/skills/
    • .codebuddy/skills/
    • .commandcode/skills/
    • .continue/skills/
    • .cortex/skills/
    • .crush/skills/
    • .factory/skills/
    • .goose/skills/
    • .junie/skills/
    • .iflow/skills/
    • .kilocode/skills/
    • .kiro/skills/
    • .kode/skills/
    • .mcpjam/skills/
    • .vibe/skills/
    • .mux/skills/
    • .openhands/skills/
    • .pi/skills/
    • .qoder/skills/
    • .qwen/skills/
    • .roo/skills/
    • .trae/skills/
    • .windsurf/skills/
    • .zencoder/skills/
    • .neovate/skills/
    • .pochi/skills/
    • .adal/skills/

    Plugin Manifest Discovery

    If .claude-plugin/marketplace.json or .claude-plugin/plugin.json exists, skills declared in those files are also discovered:

    // .claude-plugin/marketplace.json
{
  "metadata": { "pluginRoot": "./plugins" },
  "plugins": [
    {
      "name": "my-plugin",
      "source": "my-plugin",
      "skills": ["./skills/review", "./skills/test"]
    }
  ]
}

    This enables compatibility with the Claude Code plugin marketplace ecosystem.

    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:

    Feature OpenCode OpenHands Claude Code Cline CodeBuddy Codex Command Code Kiro CLI Cursor Antigravity Roo Code Github Copilot Amp OpenClaw Neovate Pi Qoder Zencoder
    Basic skills Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
    allowed-tools Yes Yes Yes Yes Yes Yes Yes No Yes Yes Yes Yes Yes Yes Yes Yes Yes No
    context: fork No No Yes No No No No No No No No No No No No No No No
    Hooks No No Yes Yes No No No No No No No No No No No No No No

    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.

    Environment Variables

    Variable Description
    INSTALL_INTERNAL_SKILLS Set to 1 or true to show and install skills marked as internal: true
    DISABLE_TELEMETRY Set to disable anonymous usage telemetry
    DO_NOT_TRACK Alternative way to disable telemetry 
    # Install internal skills
INSTALL_INTERNAL_SKILLS=1 npx @alexsun-top/skills add vercel-labs/agent-skills --list

    Telemetry

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

    Telemetry is automatically disabled in CI environments.

    License

    MIT