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