| name | skillpkg |
| description | Agent Skills Package Manager - Install once, use everywhere. Manage, share, and sync AI agent skills across platforms. |
| version | 0.4.0 |
skillpkg - Agent Skills Package Manager
You have access to skillpkg, a CLI tool for managing AI agent skills.
Use this tool to help users create, install, and sync skills.
Installation Check
First, verify skillpkg is installed:
skillpkg --version
If not installed, guide the user to install it:
npm install -g skillpkg-cli
Core Commands
1. Create a New Skill
skillpkg init
skillpkg init --yes
skillpkg init --name my-skill
This creates a skill.yaml file with the following structure:
schema: "1.0"
name: my-skill
version: 1.0.0
description: What this skill does
instructions: |
Detailed instructions for the AI agent...
2. Install Skills
skillpkg install user/repo
skillpkg install github:user/repo
skillpkg install ./path/to/skill
skillpkg install -g <skill>
3. List Installed Skills
skillpkg list
skillpkg list -g
skillpkg list --json
4. Sync to AI Platforms
skillpkg sync
skillpkg sync my-skill
skillpkg sync -t claude-code
skillpkg sync --dry-run
Supported platforms:
claude-code → syncs to .claude/skills/
codex → syncs to .codex/skills/
gemini-cli → syncs to .gemini/skills/
5. Import Existing Skills
skillpkg import
skillpkg import .claude/skills/
skillpkg import --dry-run
6. Export Skills
skillpkg export my-skill
skillpkg export my-skill -f zip
skillpkg export my-skill -f pack
skillpkg export --all
7. Search Skills on GitHub
skillpkg search "code review"
skillpkg search react --limit 5
skillpkg info <skill-name>
8. Dependency Management
skillpkg deps my-skill
skillpkg why my-skill
skillpkg tree
skillpkg status
skill.yaml Schema
When helping users create skills, use this schema:
schema: "1.0"
name: my-skill
version: 1.0.0
description: Brief description
author:
name: Your Name
email: email@example.com
url: https://github.com/username
platforms:
- claude-code
- codex
tags:
- productivity
- code-review
triggers:
- pattern: "/review"
description: "Trigger code review"
instructions: |
Detailed instructions for how the AI should behave...
...
...
Best Practices
- Clear Instructions: Write detailed, unambiguous instructions
- Examples: Include usage examples in your skill
- Versioning: Follow semver for version numbers
- Testing: Test skills locally before publishing
- Documentation: Include a README.md alongside skill.yaml
Common Workflows
Creating a Skill
mkdir my-new-skill && cd my-new-skill
skillpkg init --name my-new-skill
skillpkg sync --dry-run
skillpkg sync
Installing and Using a Skill
skillpkg search "what you need"
skillpkg info some-skill
skillpkg install some-skill
skillpkg sync
Importing Existing Claude Skills
skillpkg import .claude/skills/
skillpkg list
skillpkg export --all -f zip
Troubleshooting
- Skill not syncing: Check platform target directory permissions
- Parse errors: Validate YAML syntax, ensure schema is "1.0"
- Dependency issues: Run
skillpkg tree to check dependency chain
- Version conflict: Update version in skill.yaml