doc-projectlisted

# agents-mercato (mct) — Project Documentation ## What is agents-mercato? agents-mercato (`mct`) is a **decentralized package manager for Claude Code agents and skills**. It solves the problem of distributing, versioning, and synchronizing Claude agent/skill definitions across teams and projects — without requiring any central registry or infrastructure. ### The Problem Claude Code agents and skills are markdown files (`.md` / `SKILL.md`) that live in a project's `.claude/` directory. Teams need to: - Share curated sets of agents and skills across multiple projects - Keep those definitions in sync when upstream authors publish updates - Detect when someone locally modifies an installed skill (drift detection) - Manage dependencies between skills (skill A requires skill B) - Avoid conflicts when multiple sources provide overlapping definitions ### The Solution mct uses **Git repositories as distribution channels** (called "markets"). A market is just a Git repo with a conventional directory structure containing agent and skill files. mct clones markets locally, indexes their contents, and lets users install entries into their projects. It then tracks versions, detects drift, resolves dependencies, and synchronizes updates — all through Git. ### How It Works End-to-End 1. **Register a market**: `mct market add <git-url>` — mct shallow-clones the repo into `~/.cache/mct/<name>/`, auto-detects its format (hierarchical or flat), and saves it to `~/.config/mct/config.yml`