Skills.sh — Agent Skills Manager

The skills.sh client for your editor.

Discover, install, and manage Agent Skills without leaving your IDE.
Search the skills.sh marketplace, keep skills up to date, and share curated skill sets with your team — all from the sidebar.

Works with VS Code · Cursor · Windsurf · Antigravity · VSCodium · any VSIX-compatible editor

Features

Marketplace

• Search and browse skills from skills.sh with trending, all-time, and hot leaderboards
• One-click install via npx skills add in an integrated terminal
• Skill detail pages with install counts, security audits, and rendered SKILL.md documentation
• Open the marketplace in a full editor tab for more space

Installed Skills

• TreeView showing all installed skills grouped by source repository
• Multi-agent awareness — see which AI tools have each skill (Claude Code, Cursor, Windsurf, etc.)
• Global (~/.agents/skills/) and project-level (.claude/skills/) scopes
• "My Skills" group for locally-authored custom skills
• SKILL.md preview (rendered Markdown) and raw file viewing
• Copy skill path to clipboard

Updates

• Detect outdated skills using the GitHub Trees API
• Badge count in the TreeView title showing available updates
• Update individual skills or all at once
• Silent background update check on startup (configurable)

Launch Claude with Skill

• Start a Claude Code session with a specific skill pre-loaded
• Configurable target: terminal CLI or Claude Code extension panel

Team Sharing

Share recommended skills with your team using a skills.json manifest:

• Add or remove skills from the manifest via context menus
• Auto-detect missing skills when opening a project with a manifest
• "Install from skills.json" to sync the entire team's skill set
• Commit skills.json to version control for team-wide consistency

{
  "skills": [
    {
      "source": "anthropics/courses",
      "skills": ["prompt-engineering", "tool-use"]
    }
  ]
}

Security & Documentation

• Browse security audit results from Gen Agent Trust Hub, Socket, and Snyk
• Read skills.sh documentation (Overview, CLI, FAQ) directly in the editor

Auto-refresh

• File system watcher detects external installs and removals
• Lock file monitoring (~/.agents/.skill-lock.json) for reliable detection on all platforms
• Re-scan on window focus (configurable)

Works Everywhere

This extension is VSIX-based and works with any compatible editor:

• VS Code
• Cursor
• Windsurf
• VSCodium (via Open VSX)
• Theia

The extension scans skill directories for 11 AI coding agents (paths verified against the skills.sh CLI source):

Skills found in multiple agent directories are deduplicated and show agent badges in the sidebar.

Installation

From VS Code Marketplace

1. Open Extensions (Ctrl+Shift+X)
2. Search "Skills.sh"
3. Click Install

From Open VSX (Cursor, Windsurf, VSCodium)

Install from open-vsx.org/extension/AbelMak/skills-sh, or search "Skills.sh" in your editor's extension panel.

Manual VSIX Install

Download the .vsix file from GitHub Releases, then:

code --install-extension skills-sh-0.1.0.vsix
# Cursor:
cursor --install-extension skills-sh-0.1.0.vsix

Quick Start

1. Install the extension
2. Open the Skills.sh sidebar (circuit-S icon in the Activity Bar)
3. Browse the Marketplace panel or check your Installed Skills
4. Click a skill to view details, then click Install
5. Right-click an installed skill and select Launch Claude with Skill to start coding

Settings

All settings are under skills-sh.* in VS Code Settings.

Commands

Available from the Command Palette (Ctrl+Shift+P):

Additional commands are available from the TreeView context menu (right-click an installed skill): Open SKILL.md, Preview SKILL.md, Launch Claude with Skill, Uninstall, Update, Copy Path, Add/Remove from skills.json.

Known Issues

npx skills update does not update the lock file hash

The skills.sh CLI's update command fails to write the updated skillFolderHash back to ~/.agents/.skill-lock.json, causing subsequent checks to always flag the same skills as outdated.

Workaround: This extension uses a remove + add approach instead (npx skills remove followed by npx skills add), which creates a fresh lock entry with the correct hash.

Upstream: vercel-labs/skills#371

Vercel check-updates API branch mismatch (resolved)

The skills.sh API endpoint checks a repo's default branch for the latest hash, but the CLI stores the hash from the main branch (falling back to master). This creates false positives for repos where the default branch differs.

Resolution: This extension bypasses the Vercel API entirely and uses the GitHub Trees API directly, matching the CLI's own branch priority.

Upstream: vercel-labs/skills#373

Requirements

• VS Code 1.93+ (or any compatible VSIX editor)
• Node.js 18+
• skills.sh CLI (npx skills) for install and uninstall operations

Roadmap

See ROADMAP.md for planned features, priorities, and what's been recently completed or dropped.

Contributing

Found a bug or have a feature request? Open an issue on GitHub.

Links

• skills.sh — Agent Skills marketplace
• GitHub Repository
• Issue Tracker
• Roadmap

License

MIT