$ asm scaffold my-awesome-skill --description "Helps with coding" Creating skill directory... Writing SKILL.md... Skill 'my-awesome-skill' created successfully! $ asm validate .claude/skills/my-awesome-skill Validating skill... Skill is valid! $ asm package .claude/skills/my-awesome-skill Packaging skill... Package created: my-awesome-skill.skill
AI Skills Manager
Create. Validate. Distribute.
A CLI toolkit for managing Agent Skills. Build, package, and share skills that extend Claude's capabilities.
Get StartedWhat problems does AI Skills Manager solve?
Agent Skills allow you to extend Claude's capabilities with custom instructions and tools. But managing these skills manually can be tedious and error-prone.
AI Skills Manager (ASM) streamlines the entire skill lifecycle: from scaffolding new skills with the correct structure, to validating them against Anthropic's specification, to packaging them for distribution and installing them across projects.
Whether you're building skills for your team or sharing them with the community, ASM ensures your skills are always valid, portable, and easy to manage.
ASM Features
Scaffolding
Create new skills with the correct directory structure and SKILL.md template. Supports both project and personal scope.
Validation
Ensure skills comply with the official Agent Skills specification. Supports JSON output for CI/CD integration.
Packaging
Create distributable .skill packages ready to share with your team or the community.
Install
Install skills from packages with automatic validation and rollback on failure.
Update
Safely update installed skills with automatic backups and atomic updates.
Uninstall
Remove skills with security checks and confirmation prompts. Supports bulk uninstall.
Installation
Install globally via npm
npm install -g ai-skills-manager
Or add as a project dependency
npm install ai-skills-manager
Usage
For complete command details, options, and examples, see the full documentation.
Available Commands
| Command | Description |
|---|---|
asm scaffold <name> |
Create a new skill with required structure |
asm validate <path> |
Validate a skill against the specification |
asm package <path> |
Create a distributable .skill package |
asm install <file> |
Install a skill from a .skill package |
asm update <name> <file> |
Update an installed skill to a new version |
asm uninstall <name> |
Remove an installed skill |
Quick Workflow
Create a skill
asm scaffold my-skill --description "A helpful skill for code reviews"
Edit SKILL.md with your instructions
code .claude/skills/my-skill/SKILL.md
Validate your skill
asm validate .claude/skills/my-skill
Package for distribution
asm package .claude/skills/my-skill --output ./dist
Share and install
asm install my-skill.skill --scope personal
FAQ
What are Agent Skills?
Skills are reusable instruction sets that extend Claude Code's capabilities. They consist of a SKILL.md file with frontmatter metadata and markdown instructions that Claude follows when the skill is activated.
Where are skills stored?
Skills can be stored in two locations: .claude/skills/ for project-specific skills, or ~/.claude/skills/ for personal skills that are available across all projects.
What's in a .skill package?
A .skill package is a ZIP archive containing the SKILL.md file and any supporting scripts. It excludes development artifacts like .git, node_modules, and editor files.
How does validation work?
ASM validates skills against the official Anthropic specification, checking for required fields, proper YAML frontmatter, valid name formats, and correct directory structure.
Is there CI/CD support?
Yes! The validate command supports --output json for machine-readable output and --quiet for pass/fail only. Exit codes are designed for pipeline integration.
What happens if an install fails?
ASM performs post-installation validation and automatically rolls back if the installed skill is invalid. Updates also create backups that can be restored if needed.
Can I preview changes before applying?
Yes! The install, update, and uninstall commands all support --dry-run to preview what would happen without making changes.
How do I report bugs or contribute?
Visit the GitHub repository to report issues, request features, or contribute to the project.