Capabilities Hub

License: MIT Node pnpm

Русская версия: README.ru.md

Local-first catalog of Skills, MCP servers, and Rules for Cursor and compatible AI agents.

Know what is installed, why it exists, when to use it, and export a project router skill so the agent stops guessing among dozens of global capabilities.

---

Why

Pain	What Hub does
Skills scattered across ~/.cursor, ~/.claude, ~/.agents	One deduplicated catalog with source paths
Agent ignores useful skills	Edit EN description, build a project router
No Russian notes for humans	Overlay RU descriptions + AI translate
Hard to curate large catalogs	AI Organize, tags, profiles, audit

Important: Hub does not change Cursor by itself. Only writing SKILL.md (EN description / router export) affects the agent. MCP enable/disable stays in Cursor settings.

---

Features

• Catalog — search, kind filters, tags, duplicates & collisions
• Overlay — RU description, whenToUse, prompt templates (local, human-facing)
• AI translate — EN → RU via OpenAI, OpenRouter, Kie.ai, Anthropic, Cursor SDK, or Ollama
• Organize — AI groups, tag suggestions, router/cleanup candidates (SSE progress)
• Router wizard — export {workspace}/.cursor/skills/<name>-router/SKILL.md
• Profiles — save Organize selections for reuse
• Audit — collisions, missing RU/EN, unused markers, Organize hints
• Help — in-app guide (RU/EN) explaining concepts and workflows
• CLI — scan, organize, export-router, audit, translate

---

Quick start

pnpm install
pnpm build
pnpm test

# Web UI — http://127.0.0.1:47200
pnpm ui

# Dev UI (Vite :47201; run `pnpm ui` in another terminal for the API)
pnpm dev:ui

Useful commands

pnpm scan:duplicates
pnpm scan:fixtures
pnpm translate:dry
pnpm translate

pnpm organize:dry
pnpm organize
pnpm export-router:dry
pnpm export-router

# Not `pnpm audit` (pnpm security) — use:
pnpm run audit
pnpm audit:json

---

Configuration

Open Settings in the UI, or edit %USERPROFILE%\.capabilities-hub\config.json (~/.capabilities-hub/config.json on macOS/Linux):

{
  "version": 1,
  "locale": "en",
  "workspace": "/path/to/your/project",
  "ai": {
    "provider": "openrouter",
    "providers": {
      "openrouter": {
        "apiKey": "sk-or-...",
        "model": "openai/gpt-4o-mini"
      }
    }
  }
}

Providers: OpenAI, OpenRouter, Kie.ai, Cursor SDK, Anthropic, Ollama (local, no key).

User data directory:

~/.capabilities-hub/
  config.json
  overlay.json
  index.cache.json
  organize.cache.json
  profiles.json
  backups/

---

UI map

Area	Purpose
Catalog	Browse / edit capabilities
Organize	AI summary, apply tags, router candidates
Audit	Health check of the catalog
Help	Concepts & how-to (this guide in-app)
Header RU | EN	UI language
Settings	Workspace + AI provider

Editor for “Open file”: CAPABILITIES_HUB_EDITOR (default cursor).

---

Monorepo layout

packages/
  scanner/   # filesystem scan, parse, dedupe, secret masking
  store/     # overlay, cache, translate, organize, router, profiles, audit
  server/    # localhost Fastify API
  web/       # Vite + React dashboard
  cli/       # capabilities-hub CLI
fixtures/
docs/

---

Documentation

Doc	Contents
docs/PROJECT.md	Architecture, MVP scope, decisions
docs/V2-AI-ORGANIZE.md	Organize & Router (v2.0)
fixtures/README.md	Fixture catalog for tests
README.ru.md	Russian README

---

Troubleshooting

Port 47200 in use

# Windows
netstat -ano | findstr :47200

# Or pick another port
capabilities-hub ui --port 47201

UI shows an old build

pnpm build && pnpm ui

Stop the previous process on :47200 first.

Tags missing after restart

Tags live in overlay.json. Hub re-merges overlay into the scan cache on startup. Re-apply once if you used an older build before that fix.

---

License

MIT