claude-skill-manager

Claude Skill Manager (CSM)

A persistent, local-first operating layer for the Claude Code ecosystem. Installed as a divan plugin, CSM runs as an always-on background daemon that scouts, evaluates, and proposes changes to your skill/plugin stack — and can build new components when nothing suitable exists.

How It Works

┌─────────────────────────────────────────────────────────┐
│                    tmux: csm-daemon                      │
│                                                          │
│  Claude Code + CSM daemon agent                          │
│  ├── Scouts sources continuously                         │
│  ├── Evaluates candidates against your stack             │
│  ├── Generates proposals (never silently installs)       │
│  ├── Responds to /csm commands from user                 │
│  └── Dispatches subagent team:                           │
│      ├── csm-scout      (source discovery)               │
│      ├── csm-evaluator  (deep comparison)                │
│      ├── csm-proposer   (proposal generation)            │
│      ├── csm-builder    (create new components)          │
│      └── csm-researcher (web research)                   │
└─────────────────────────────────────────────────────────┘
         ▲                              ▲
         │ /csm commands                │ csm CLI
         │ (inside tmux)                │ (any terminal)
         │                              │
    ┌────┴────┐                    ┌────┴────┐
    │ User in │                    │ User in │
    │  tmux   │                    │  shell  │
    └─────────┘                    └─────────┘

Setup

Prerequisites

• Python 3.12+ with uv
• Node.js 20+ (for web UI)
• divan (plugin manager)
• tmux

Install

# Install as a divan plugin (when published)
divan add claude-skill-manager

# Or for development, install dependencies directly:
cd claude-skill-manager
uv sync --all-extras
cd apps/web && npm install && cd ../..

# Add csm to PATH (optional)
ln -s $(pwd)/scripts/csm ~/.local/bin/csm

Usage

Start the Daemon

# Launch persistent daemon in tmux
csm daemon
# or
./scripts/start-daemon.sh

# Attach to see what it's doing
csm attach
# or
tmux attach -t csm-daemon

Interactive Commands (inside any Claude Code session)

/csm status              Show registry overview
/csm search <query>      Search for items
/csm inspect <item-id>   Detailed item view
/csm compare <a> <b>     Side-by-side comparison
/csm suggest             Get recommendations
/csm propose             Generate proposals
/csm apply <proposal-id> Apply with snapshot safety
/csm scout               Run a scouting pass
/csm-find <what>         Deep search + web research + offer to build
/csm-stop                Stop the daemon

CLI (from any terminal)

csm status               # Registry overview
csm search memory        # Search
csm scout                # Scout sources
csm propose              # Generate proposals
csm serve                # Start API + web UI
csm divan add <plugin>   # Add via divan
csm find "slack tool"    # Queue research request to daemon
csm build "arxiv reader" # Queue build request to daemon

Web Dashboard

csm serve   # API on :8000, docs at /docs
csm web     # Web UI on :5173

Dashboard shows: installed stack, candidates, proposals, source status, graph visualization, snapshots.

Architecture

Divan Plugin Layer

.claude-plugin/plugin.json    Plugin manifest
skills/                       Natural language triggers
  csm-find-skill/             "find me a plugin for..."
  csm-manage-stack/           "install/remove/upgrade..."
  csm-ecosystem-advisor/      "what should I install..."
agents/                       Subagent team
  csm-daemon.md               Main persistent agent
  csm-scout.md                Discovery agent
  csm-evaluator.md            Comparison/scoring agent
  csm-proposer.md             Proposal generation agent
  csm-builder.md              Component creation agent
  csm-researcher.md           Web research agent
commands/                     Slash commands
  csm.md                      /csm <action>
  csm-daemon.md               /csm-daemon
  csm-find.md                 /csm-find <query>
  csm-stop.md                 /csm-stop
hooks/
  hooks.json                  Stop hook (keeps daemon alive)

Python Engine

packages/core/                Domain models, registry, evaluator, proposer
packages/connectors/          GitHub, marketplace, local directory connectors
packages/agents/              Scout, pipeline, apply orchestration
apps/api/                     FastAPI REST backend
apps/cli/                     Typer CLI
apps/web/                     React + Vite + Tailwind dashboard

Registry (Source of Truth)