| name | skillmeat-cli |
| description | Manage Claude Code environments using natural language. Use this skill when:
- User wants to add, deploy, or manage Claude Code artifacts (skills, commands, agents, MCP servers)
- User asks about available skills or capabilities ("what skills exist for X?")
- User wants to search for artifacts to solve a problem ("I need something for PDF processing")
- Agent needs to discover or deploy capabilities for a development task
- User wants to create, import, or share artifact bundles
- User mentions "skillmeat", "claudectl", or managing their Claude Code setup
Supports conversational requests and the claudectl power-user alias.
|
SkillMeat CLI Skill
Natural language interface for managing Claude Code artifacts and environments.
Quick Start
Common Operations
| User Says | What Happens |
|---|
| "Add the PDF skill" | Adds ms-office-suite:pdf to collection |
| "Deploy canvas to this project" | Deploys canvas-design skill to .claude/skills/ |
| "What skills do I have?" | Lists artifacts in current collection |
| "Search for database skills" | Searches all sources for database-related skills |
| "Update all my skills" | Syncs collection with upstream sources |
| "Remove the xlsx skill" | Removes artifact from collection |
For AI Agents
When you identify a capability gap during development:
- Search for relevant artifacts (don't announce this)
- Suggest to user: "This task would benefit from the X skill. Would you like me to add it?"
- Wait for explicit permission before deploying
- Deploy only what was approved
Never auto-deploy artifacts without user permission.
Workflows
Discovery: Finding Artifacts
When user needs a capability or asks what's available:
skillmeat search "<query>" --type skill
skillmeat search "<query>" --type skill --json
skillmeat list --type skill
skillmeat show <artifact-name>
Artifact Types: skill, command, agent, mcp, hook
Common Sources:
anthropics/skills/* - Official Anthropic skillsanthropics/example-skills/* - Example/template skills- Community sources (user-configured)
Deployment: Adding Artifacts
When user wants to add or deploy an artifact:
Step 1: Add to Collection
skillmeat add skill anthropics/skills/canvas-design
skillmeat add skill anthropics/skills/canvas-design@v1.0.0
skillmeat add skill username/repo/path/to/skill
Step 2: Deploy to Project
skillmeat deploy <artifact-name>
skillmeat deploy <artifact-name> --project /path/to/project
skillmeat list --project .
Management: Updating & Removing
skillmeat diff <artifact-name>
skillmeat update <artifact-name>
skillmeat sync --all
skillmeat remove <artifact-name>
skillmeat undeploy <artifact-name> --project .
Bundles: Sharing Setups
skillmeat bundle create my-setup
skillmeat sign create my-setup.zip
skillmeat bundle import setup.zip
skillmeat sign verify setup.zip
claudectl Alias
Power users can use claudectl for simplified commands with smart defaults:
claudectl add pdf
claudectl deploy pdf
claudectl search database
claudectl status
claudectl sync
claudectl bundle my-setup
Setup claudectl
Add to ~/.bashrc or ~/.zshrc:
alias claudectl='skillmeat'
Or for smart defaults wrapper, see claudectl-setup.md.
AI Agent Guidelines
When to Suggest Artifacts
DO suggest when:
- User explicitly asks about capabilities
- Clear capability gap identified (e.g., "process this PDF" but no PDF skill)
- User asks for help with a task that has a well-known skill
DON'T suggest when:
- Task can be completed without additional skills
- User is in the middle of focused work
- Suggestion would be redundant (skill already deployed)
Suggestion Format
I notice this task involves [capability]. The [artifact-name] skill
could help with this. Would you like me to add it to the project?
It provides: [brief description]
Source: [source path]
Permission Protocol
- Always ask before deploying
- Show what will change (files to be created)
- Confirm success after deployment
- Suggest related artifacts only if relevant
Command Reference
For complete command documentation, see command-quick-reference.md.
Most Used Commands
| Command | Purpose |
|---|
skillmeat search <query> | Find artifacts |
skillmeat add <type> <source> | Add to collection |
skillmeat deploy <name> | Deploy to project |
skillmeat list | List in collection |
skillmeat list --project . | List deployed in project |
skillmeat show <name> | Show artifact details |
skillmeat sync | Sync with upstream |
skillmeat remove <name> | Remove from collection |
Artifact Resolution
The skill resolves fuzzy names to full identifiers:
| User Says | Resolves To |
|---|
| "pdf" | ms-office-suite:pdf or example-skills:pdf |
| "canvas" | canvas-design |
| "xlsx" | ms-office-suite:xlsx |
| "docx" | ms-office-suite:docx |
When ambiguous, present options and ask user to choose.
Project Context Analysis
When recommending artifacts, analyze project context:
| Project Indicator | Recommended Artifacts |
|---|
package.json with React | frontend-design, webapp-testing |
pyproject.toml | Python-related skills |
| FastAPI imports | openapi-expert, backend skills |
.claude/ directory | Check what's already deployed |
tests/ directory | Testing-related skills |
See analyze-project.js for analysis script.
Error Handling
Common Issues
| Error | Solution |
|---|
| "Artifact not found" | Check spelling, try search first |
| "Already in collection" | Use deploy to deploy existing artifact |
| "Permission denied" | Check directory permissions |
| "Rate limited" | Set GitHub token: skillmeat config set github-token <token> |
Getting Help
skillmeat --help
skillmeat <command> --help
skillmeat web doctor
Related Skills
- skill-builder: Create new skills
- skill-creator: Design skill workflows
- chrome-devtools: Browser automation (example of CLI wrapper skill)
