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:

# 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

# 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

# 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

# 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

# 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:

claudectl 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:

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

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

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