// Use when the user wants to list, search, install, remove, inspect, validate, audit, or update skills. Use when asking "what skills do I have", "is there a skill for X", "check my skills for issues", or "install a skill". Also use when checking skill health across agents (Claude Code, Codex, Agents CLI).
[HINT] Download the complete skill directory including SKILL.md and all related files
name
skills-manager
description
Use when the user wants to list, search, install, remove, inspect, validate, audit, or update skills. Use when asking "what skills do I have", "is there a skill for X", "check my skills for issues", or "install a skill". Also use when checking skill health across agents (Claude Code, Codex, Agents CLI).
license
Apache 2.0
metadata
{"status":"experimental"}
Skills Manager
Unified skill lifecycle management across agents.
Usage
/skills-manager # Quick status overview
/skills-manager list # All skills with origin, description, agent
/skills-manager search <query> # Search skills.sh ecosystem
/skills-manager install <source> # Install from ecosystem or GitHub
/skills-manager remove <name> # Remove a skill
/skills-manager inspect <name> # Deep-read: frontmatter, scripts, structure
/skills-manager validate [path] # Validate structure and frontmatter
/skills-manager audit # System-wide health check
/skills-manager update # Check and apply ecosystem updates
/skills-manager create # Guided creation (delegates to skill-creator)
Status (/skills-manager)
Quick overview of all installed skills.
bun ~/.claude/skills/skills-manager/scripts/manage.ts status
Shows: total count, breakdown by origin (local/ecosystem/symlink) and agent, lock file stats, validation issue count.
List (/skills-manager list)
All installed skills across agents with metadata.
Local skills:
bun ~/.claude/skills/skills-manager/scripts/manage.ts list
Ecosystem skills (via npx):
npx skills list -g
Present both outputs together — local list shows origin/agent/description, ecosystem list shows remote registry state.
Search (/skills-manager search )
Search the skills.sh ecosystem for installable skills.
npx skills find <query>
Present results with name, source, and install command. If no results, suggest npx skills find (interactive mode) or creating a custom skill.
Install (/skills-manager install )
Install a skill from the ecosystem or GitHub.
npx skills add <source> -g -y
Source formats:
owner/repo@skill-name — from skills.sh registry
https://github.com/owner/repo — from GitHub directly
Local path — for development
The -g flag installs globally (user-level), -y skips confirmation.
After install, run validate to confirm the skill is well-formed:
bun ~/.claude/skills/skills-manager/scripts/manage.ts validate ~/.agents/skills/<name>
Remove (/skills-manager remove )
Remove an installed skill.
npx skills remove <name> -g -y
Inspect (/skills-manager inspect )
Deep-read a specific skill by name.
bun ~/.claude/skills/skills-manager/scripts/manage.ts inspect <name>
Shows: path, origin, agent, symlink target, frontmatter fields, scripts with size and executable status, references directory listing, SKILL.md heading structure.
Validate (/skills-manager validate [path])
Validate skill structure and frontmatter against the spec.
bun ~/.claude/skills/skills-manager/scripts/manage.ts validate <path>
Path can be:
A single skill directory (containing SKILL.md)
A directory of skills (e.g., ~/.claude/skills)
Checks performed
Errors (blocking):
SKILL.md exists with valid frontmatter
Required fields: name, description
Name: hyphen-case, max 64 chars, no leading/trailing/consecutive hyphens
Description: 50+ chars, max 1024 chars, no angle brackets
No forbidden files (README.md, CHANGELOG.md, etc.)
