---

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

For AI Agents

When you identify a capability gap during development:

1. Search for relevant artifacts (don't announce this)
2. Suggest to user: "This task would benefit from the X skill. Would you like me to add it?"
3. Wait for explicit permission before deploying
4. 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:

Copy# Search all sources
skillmeat search "<query>" --type skill

# Search with JSON output (for parsing)
skillmeat search "<query>" --type skill --json

# List what's in collection
skillmeat list --type skill

# Show artifact details
skillmeat show <artifact-name>

Artifact Types: skill, command, agent, mcp, hook

Common Sources:

• anthropics/skills/* - Official Anthropic skills
• anthropics/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

Copy# Add from official source
skillmeat add skill anthropics/skills/canvas-design

# Add specific version
skillmeat add skill anthropics/skills/canvas-design@v1.0.0

# Add from any GitHub repo
skillmeat add skill username/repo/path/to/skill

Step 2: Deploy to Project

Copy# Deploy to current project
skillmeat deploy <artifact-name>

# Deploy to specific project
skillmeat deploy <artifact-name> --project /path/to/project

# Check what's deployed
skillmeat list --project .

Management: Updating & Removing

Copy# Check for updates
skillmeat diff <artifact-name>

# Update specific artifact
skillmeat update <artifact-name>

# Update all artifacts
skillmeat sync --all

# Remove from collection
skillmeat remove <artifact-name>

# Undeploy from project
skillmeat undeploy <artifact-name> --project .

Bundles: Sharing Setups

Copy# Create bundle from current collection
skillmeat bundle create my-setup

# Sign bundle for distribution
skillmeat sign create my-setup.zip

# Import bundle
skillmeat bundle import setup.zip

# Verify bundle signature
skillmeat sign verify setup.zip

---

claudectl Alias

Power users can use claudectl for simplified commands with smart defaults:

Copyclaudectl add pdf              # → skillmeat add skill anthropics/skills/pdf
claudectl deploy pdf           # → skillmeat deploy pdf --project .
claudectl search database      # → skillmeat search database --type skill
claudectl status               # → skillmeat list --project . --json
claudectl sync                 # → skillmeat sync --all
claudectl bundle my-setup      # → skillmeat bundle create my-setup

Setup claudectl

Add to ~/.bashrc or ~/.zshrc:

Copyalias 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

CopyI 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

1. Always ask before deploying
2. Show what will change (files to be created)
3. Confirm success after deployment
4. Suggest related artifacts only if relevant

---

Command Reference

For complete command documentation, see command-quick-reference.md.

Most Used Commands

Artifact Resolution

The skill resolves fuzzy names to full identifiers:

When ambiguous, present options and ask user to choose.

---

Project Context Analysis

When recommending artifacts, analyze project context:

See analyze-project.js for analysis script.

---

Error Handling

Common Issues

Getting Help

Copyskillmeat --help              # General help
skillmeat <command> --help    # Command-specific help
skillmeat web doctor          # Diagnose environment issues

---

Related Skills

• skill-builder: Create new skills
• skill-creator: Design skill workflows
• chrome-devtools: Browser automation (example of CLI wrapper skill)