skillmeat 0.9.0

Personal collection manager for Claude Code artifacts (Skills, Commands, Agents, MCP, Hooks)

SkillMeat

Personal collection manager for Claude Code artifacts

Organize, deploy, and sync your Claude Code skills, commands, agents, hooks, and MCP servers across projects with a powerful CLI and web interface.

The missing management layer for Claude Code.

SkillMeat is a professional-grade collection manager designed to bridge the gap between building Claude Code artifacts and actually using them at scale. It transforms scattered .claude files into a version-controlled, searchable, and shareable library.

---

💡 Why SkillMeat?

As you build more complex agentic workflows with Claude Code, managing your Skills, Commands, Agents, and MCP Servers becomes a bottleneck.

• The Problem: Artifacts are often trapped within individual projects. If you improve a "Code Review" skill in one repo, your other ten projects are now running an outdated version. Sharing these tools with a team usually involves brittle copy-pasting.
• The Solution: SkillMeat provides a centralized source of truth. You manage your artifacts in a global collection and "deploy" them to projects and deployment profiles (claude_code, codex, gemini, cursor). When you update the global version, SkillMeat handles the sync, drift detection, and versioning across every project on your machine.

🎯 Who is it for?

• Individual Power Users: Developers who have a growing library of custom Claude skills and need to keep them in sync across dozens of local repositories.
• Team Leads & Architects: Teams looking to standardize their agentic SDLC by sharing "Golden Path" skills, rules, and MCP configurations.
• Artifact Creators: Developers building tools for the Claude community who need a structured way to package, sign, and publish their work.

---

🚀 Key Capabilities

• 📦 Three-Tier Architecture: Manage artifacts at the Source (GitHub/Local), Collection (Your Library), and Project (Deployment) levels.
• 🔄 Intelligent Sync: Bidirectional synchronization with built-in drift detection. See exactly how your project-specific customizations differ from your global library.
• 🛡️ Safety-First Versioning: Automatic snapshots before any destructive operation. If a new skill version breaks your workflow, roll back with a single command.
• 🌐 Dual Interface: Use the high-performance CLI for your terminal workflows or the Next.js Web UI for visual discovery and analytics.
• 🧩 MCP Orchestration: Centralized management for Model Context Protocol servers—deploy, health-check, and configure environment variables from one place.
• 🔐 Authentication & RBAC: Pluggable auth with zero-auth local mode, Clerk integration for teams, and role/scope-based access control. Learn more →
• 🏢 Enterprise Storage: Optional PostgreSQL backend with multi-tenant isolation, team workspaces, and data ownership controls. Learn more →

---

Comparison of artifact management with standard Claude Code:

Feature	Standard Claude Code	With SkillMeat
Storage	Scattered in .claude/ dirs	Centralized Library (~/.skillmeat)
Updates	Manual copy-paste	Automated Sync & Merge
Versioning	None	Snapshots & Rollbacks
Sharing	Manual file transfer	Signed .skillmeat-pack Bundles
Visibility	Terminal only	Full Web Dashboard & Analytics

Screenshots

Full dashboard with sidebar, stats cards, trends chart, top artifacts widget. Light mode.	Grid view with 9+ cards, toolbar visible, mix of artifact types, some tags shown
Source cards with repo names, artifact counts, scan status. Filter bar visible.	Summary cards, deployment list with mixed statuses (synced, modified, outdated)
Diff viewer with red/green highlighting, sync buttons visible, modal context	Show init, add, deploy, list commands with Rich formatted output

Quick Start

Get started with SkillMeat in minutes.

Installation

# Using pip
pip install skillmeat

# Using uv (recommended)
uv tool install skillmeat

Basic Workflow

# Initialize your collection
skillmeat init

# Add a skill from GitHub
skillmeat add skill anthropics/skills/canvas-design

# Deploy to your project
skillmeat deploy canvas --scope user

# List your artifacts
skillmeat list

Multi-Platform Deployments

# Scaffold all profile roots for a project
skillmeat init --project-path /path/to/project --all-profiles

# Deploy to one profile
skillmeat deploy canvas --project /path/to/project --profile codex

# Deploy to all profiles
skillmeat deploy canvas --project /path/to/project --all-profiles

Web Interface

# Start the web UI with development servers
skillmeat web dev

# Open http://localhost:3000 to access the dashboard

Deployment

SkillMeat supports three deployment patterns. Choose one below:

Pattern	Use Case	Quick Start
Local	Personal testing, development	cp .env.local.example .env && docker compose --profile local up -d
Local + Auth	Personal with login	cp .env.local-auth.example .env && docker compose --profile local-auth up -d
Enterprise	Teams, production	cp .env.enterprise.example .env && docker compose --profile enterprise up -d

All deployment patterns use Docker Compose for consistency. See the Deployment Guide for:

• Complete quick-start commands and decision tree
• Pattern-specific setup (local, enterprise)
• Configuration reference
• Troubleshooting guide

For development with hot reload and full debugging, see Development Environment.

Authentication & Database (Optional)

• Local mode (default): No authentication, SQLite database, single-user
• Local + Auth: Clerk JWT authentication, SQLite database, personal use with login
• Enterprise: Clerk JWT or PAT authentication, PostgreSQL database, multi-tenant with team isolation

See Deployment Guide for detailed auth setup and the Security Guide for RBAC and tenant isolation details.

For complete CLI documentation, see the Quickstart Guide and CLI Commands.

Features

125+ CLI commands | 175+ API endpoints | 28 web pages

Collection Management

Organize artifacts in named collections

Feature	Description
Multi-Collection Support	Organize by context (skillmeat collection create)
Multiple View Modes	Grid/List/Grouped views
Tag-Based Filtering	Filter by tags
Infinite Scroll	Progressive loading

Deployment & Projects

Deploy anywhere, track everything

Feature	Description
One-Command Deploy	Deploy in seconds (skillmeat deploy)
Deployment Tracking	Track all deployments (skillmeat status)
Multi-Platform Profiles	Profile-aware deploy (skillmeat deploy --profile codex)
Project Management	Manage projects
Update Alerts	Update notifications

Deployment Sets

Group and batch-deploy artifact bundles

Feature	Description
Named Deployment Sets	Composable deployment bundles
Nested Composition	Sets within sets
Batch Deploy	One-click set deployment
Set Detail Modal	Rich modal-based management
Minified Member Cards	Compact member preview

Intelligence & Sync

Smart sync with conflict resolution

Feature	Description
Drift Detection	Detect changes (skillmeat sync check)
Bidirectional Sync	Two-way sync (skillmeat sync pull)
Diff Preview	Preview changes (skillmeat sync preview)
Merge Strategies	Flexible merge
Automatic Rollback	Safe updates

Marketplace & Discovery

Discover and share artifacts

Feature	Description
GitHub Sources	Import from GitHub
Semantic Tree Navigation	Browse folder structure
Cross-Source Search	Search everywhere
Trust & Quality Scores	Quality indicators
Bundle Publishing	Share with team (skillmeat marketplace-publish)

Analytics & Insights

Track usage, identify patterns

Feature	Description
Usage Tracking	Track usage (skillmeat analytics usage)
Top Artifacts	Most used (skillmeat analytics top)
Cleanup Suggestions	Cleanup help (skillmeat analytics cleanup)
Trend Analysis	Usage trends (skillmeat analytics trends)

Search & Discovery

Find anything instantly

Feature	Description
Smart Search	Search everything (skillmeat search)
Duplicate Detection	Find duplicates (skillmeat find-duplicates)
Ripgrep Integration	Fast search

Similar Artifacts Detection

Intelligent similarity scoring with caching and optional embeddings

Feature	Description
Multi-Dimensional Scoring	Intelligent scoring (skillmeat similar)
Pre-Computed Cache	Sub-200ms cached results
Optional Semantic Embeddings	Optional embeddings
Collection Consolidation	Merge duplicates (skillmeat consolidate)
Configurable Scoring	Tunable detection (skillmeat similar --min-score)

Versioning & Safety

Snapshots and rollback

Feature	Description
Collection Snapshots	Backup collection (skillmeat snapshot)
Rollback Support	Easy restore (skillmeat rollback)
Version History	View history (skillmeat history)

MCP Server Management

Model Context Protocol servers

Feature	Description
MCP Installation	Install MCP servers (skillmeat mcp add)
MCP Deploy	Deploy servers (skillmeat mcp deploy)
Health Monitoring	Monitor health (skillmeat mcp health)

Context Entities

Project configuration artifacts

Feature	Description
Context Entity Management	Manage project config (skillmeat context)
Context Deploy	Deploy config (skillmeat context deploy)
Memory Inbox	Review project memory
Context Modules	Reusable context modules
Context Pack Preview	Budgeted context packs
Entity Type Configuration	Configurable entity types
Custom Entity Types	User-defined types
Enhanced Creation Form	Smart entity creation
Multi-Select Categories	Flexible categorization
Platform-Aware Deployment	Multi-platform assembly

Team Collaboration

Share and collaborate

Feature	Description
Bundle Creation	Create bundles (skillmeat bundle create)
Vault Connectors	Team storage (skillmeat vault)
Cryptographic Signing	Secure sharing (skillmeat sign)

Composite Artifacts

Multi-artifact packages with smart import

Feature	Description
Plugin Import	One-click plugin import (skillmeat add)
Composite Detection	Auto-detect plugins
Hash-Based Deduplication	Smart dedup
Relationship Browsing	Navigate relationships
Plugin Deployment	Deploy plugins (skillmeat deploy)
Composite Bundle Export	Export as bundle (skillmeat export)

Workflow Orchestration Engine

Design, validate, and execute multi-step agentic workflows

Feature	Description
Workflow Builder	Visual workflow design (skillmeat workflow create)
Workflow Validation	Schema & cycle validation (skillmeat workflow validate)
Execution Planning	Smart execution planning (skillmeat workflow plan)
Workflow Execution	Execute with tracking (skillmeat workflow run)
Execution Dashboard	Real-time monitoring
Workflow Library	Saved workflows browser
Workflow Versioning	Version history & rollback (skillmeat workflow show)
Workflow Export	Export as YAML/JSON (skillmeat workflow export)

Three-Way Interface

CLI + Web UI + API

Feature	Description
Powerful CLI	Full CLI (skillmeat --help)
Visual Web UI	Web interface (skillmeat web dev)
REST API	REST API

---

Artifact Types

SkillMeat manages multiple artifact types for Claude Code:

Type	Description
Skill	Specialized capabilities for Claude
Command	Custom slash commands
Agent	Autonomous task executors
MCP Server	Model Context Protocol servers
Hook	Event-triggered automations
Plugin	Multi-artifact packages bundling skills, commands, and agents

CLI Reference

SkillMeat provides 125+ commands across 24 command groups.

Quick Reference

Category	Commands
Collection Management	`skillmeat collection create`
Deployment & Projects	`skillmeat deploy`, `skillmeat status`, `skillmeat deploy --profile codex`
Intelligence & Sync	`skillmeat sync check`, `skillmeat sync pull`, `skillmeat sync preview`
Marketplace & Discovery	`skillmeat marketplace-publish`
Analytics & Insights	`skillmeat analytics usage`, `skillmeat analytics top`, `skillmeat analytics cleanup`, `skillmeat analytics trends`
Search & Discovery	`skillmeat search`, `skillmeat find-duplicates`
Similar Artifacts Detection	`skillmeat similar`, `skillmeat consolidate`, `skillmeat similar --min-score`
Versioning & Safety	`skillmeat snapshot`, `skillmeat rollback`, `skillmeat history`
MCP Server Management	`skillmeat mcp add`, `skillmeat mcp deploy`, `skillmeat mcp health`
Context Entities	`skillmeat context`, `skillmeat context deploy`
Team Collaboration	`skillmeat bundle create`, `skillmeat vault`, `skillmeat sign`
Composite Artifacts	`skillmeat add`, `skillmeat deploy`, `skillmeat export`
Workflow Orchestration Engine	`skillmeat workflow create`, `skillmeat workflow validate`, `skillmeat workflow plan`, `skillmeat workflow run`, `skillmeat workflow show`, `skillmeat workflow export`
Three-Way Interface	`skillmeat --help`, `skillmeat web dev`

Core Commands

# Collection Management
skillmeat init                    # Initialize collection or project
skillmeat add <source>            # Add artifact from GitHub/local
skillmeat list                    # List all artifacts
skillmeat search <query>          # Search artifacts

# Deployment
skillmeat deploy <artifact>       # Deploy artifact to project
skillmeat status                  # Show deployment status
skillmeat undeploy <artifact>     # Remove deployment

# Sync & Updates
skillmeat sync check              # Check for drift/updates
skillmeat sync pull               # Pull changes from projects
skillmeat sync push               # Push updates to projects

# Web Interface
skillmeat web dev                 # Start development servers
skillmeat web build               # Build for production
skillmeat web start               # Start production servers

Command Groups

Collection Management - Organize artifacts in named collections

Command	Description
skillmeat collection create	Organize by context

Deployment & Projects - Deploy anywhere, track everything

Command	Description
skillmeat deploy	Deploy in seconds
skillmeat status	Track all deployments
skillmeat deploy --profile codex	Profile-aware deploy

Intelligence & Sync - Smart sync with conflict resolution

Command	Description
skillmeat sync check	Detect changes
skillmeat sync pull	Two-way sync
skillmeat sync preview	Preview changes

Marketplace & Discovery - Discover and share artifacts

Command	Description
skillmeat marketplace-publish	Share with team

Analytics & Insights - Track usage, identify patterns

Command	Description
skillmeat analytics usage	Track usage
skillmeat analytics top	Most used
skillmeat analytics cleanup	Cleanup help
skillmeat analytics trends	Usage trends

Search & Discovery - Find anything instantly

Command	Description
skillmeat search	Search everything
skillmeat find-duplicates	Find duplicates

Similar Artifacts Detection - Intelligent similarity scoring with caching and optional embeddings

Command	Description
skillmeat similar	Intelligent scoring
skillmeat consolidate	Merge duplicates
skillmeat similar --min-score	Tunable detection

Versioning & Safety - Snapshots and rollback

Command	Description
skillmeat snapshot	Backup collection
skillmeat rollback	Easy restore
skillmeat history	View history

MCP Server Management - Model Context Protocol servers

Command	Description
skillmeat mcp add	Install MCP servers
skillmeat mcp deploy	Deploy servers
skillmeat mcp health	Monitor health

Context Entities - Project configuration artifacts

Command	Description
skillmeat context	Manage project config
skillmeat context deploy	Deploy config

Team Collaboration - Share and collaborate

Command	Description
skillmeat bundle create	Create bundles
skillmeat vault	Team storage
skillmeat sign	Secure sharing

Composite Artifacts - Multi-artifact packages with smart import

Command	Description
skillmeat add	One-click plugin import
skillmeat deploy	Deploy plugins
skillmeat export	Export as bundle

Workflow Orchestration Engine - Design, validate, and execute multi-step agentic workflows

Command	Description
skillmeat workflow create	Visual workflow design
skillmeat workflow validate	Schema & cycle validation
skillmeat workflow plan	Smart execution planning
skillmeat workflow run	Execute with tracking
skillmeat workflow show	Version history & rollback
skillmeat workflow export	Export as YAML/JSON

Three-Way Interface - CLI + Web UI + API

Command	Description
skillmeat --help	Full CLI
skillmeat web dev	Web interface

---

For complete command documentation, run:

skillmeat --help
skillmeat <command> --help

Documentation

Comprehensive guides and references to help you get the most out of SkillMeat.

User Guides

• Quickstart Guide - Installation, setup, and first steps
• CLI Authentication - Login, PAT setup, and credential management
• Multi-Platform Upgrade Guide - Upgrade legacy projects and adopt deployment profiles
• Zero-Auth → Authenticated Migration - Upgrade from local to authenticated mode
• Memory & Context Guide - Memory Inbox, modules, and context pack workflows
• Memory Inbox Guide - Triage, lifecycle, and keyboard-first memory review
• Context Modules Guide - Selector-driven modules and pack generation
• CLI Commands - Complete command documentation
• Web Commands - Web interface CLI usage
• Examples - Common workflows and use cases
• Beta Program - Beta testing information

Development

• API Development - Backend development guide
• Web Development - Frontend development guide
• API Authentication - API auth methods, scopes, and examples
• Developer Auth Patterns - Writing auth-aware endpoints and tests
• Memory Context Developer Guide - Architecture, APIs, and extension points
• Contributing Guide - Development setup, coding standards, and guidelines

Security & Operations

• Security & RBAC Model - Roles, scopes, tenant isolation, threat model
• Deployment & Rollout - Feature flags, canary deployment, monitoring

Contributing

Contributions are welcome! SkillMeat is built with Python, FastAPI, Next.js, and React.

Development Setup

# Clone the repository
git clone https://github.com/yourusername/skillmeat.git
cd skillmeat

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest -v --cov=skillmeat

# Start development servers
skillmeat web dev

Code Quality

# Format code (required)
black skillmeat

# Type checking
mypy skillmeat --ignore-missing-imports

# Lint
flake8 skillmeat --select=E9,F63,F7,F82

Contribution Guidelines

• Follow existing code patterns and conventions
• Add tests for new features
• Update documentation for user-facing changes
• Run code quality checks before submitting
• Write clear commit messages

For detailed guidelines, see CONTRIBUTING.md.

Reporting Issues

Found a bug or have a feature request? Open an issue on GitHub Issues.

License

SkillMeat is released under the MIT License.

Support

• Documentation - Comprehensive guides and references
• GitHub Issues - Bug reports and feature requests
• Discussions - Community Q&A and ideas

Credits

Built with:

• Python 3.9+ - Core CLI and backend
• FastAPI - REST API framework
• Next.js 15 - React framework
• Radix UI - Accessible component primitives
• shadcn/ui - Beautiful component library
• TanStack Query - Data fetching and caching
• Rich - Terminal formatting

Developed with support from the Claude Code community.