skilldb

CLI, TypeScript SDK и MCP Server для SkillDB — находить, устанавливать и управлять навыками AI‑агентов.

5 900+ экспертных навыков в 429 наборах для Claude Code, Cursor, Windsurf, VS Code и любого MCP‑совместимого инструмента ИИ.

Open source for transparency. Это полный исходник для npm‑пакета [skilldb] — CLI и MCP server, которые работают на вашем устройстве и управляют вашим API key. Он публикуется в npm через [Trusted Publishing] (OIDC, с provenance), поэтому опубликованный артефакт можно проверить по этому репозиторию. Проводите аудит, PR приветствуются. Лицензия MIT.

MCP Server

Подключайте SkillDB напрямую к вашему инструменту кодирования ИИ через Model Context Protocol:

# Step 1 (optional): install globally. You can also skip this — the npx form below works without it.
npm install -g skilldb

# Step 2: Get your free API key at https://skilldb.dev/api-access

# Step 3: Add to Claude Code (with API key for full content)
claude mcp add skilldb -- npx -p skilldb skilldb-mcp --api-key sk_live_YOUR_KEY

Примечание: skilldb-mcp — это бинарник внутри пакета skilldb, а не отдельный npm-пакет — всегда вызывайте его как npx -p skilldb skilldb-mcp (а не npx skilldb-mcp).

⚠️ Без API key можно выполнять поиск и просмотр навыков (только метаданные).

С бесплатным API key вы получаете полный контент навыков — фактические инструкции в markdown, которые использует ваш агент.

Получите ключ за 30 секунд на [skilldb.dev/api-access].

Cursor — добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "skilldb": {
      "command": "npx",
      "args": ["-p", "skilldb", "skilldb-mcp"]
    }
  }
}

Windsurf — добавьте в mcp_config.json:

{
  "mcpServers": {
    "skilldb": {
      "command": "npx",
      "args": ["-p", "skilldb", "skilldb-mcp", "--api-key", "sk_live_xxx"]
    }
  }
}

VS Code — однострочник:

code --add-mcp '{"name":"skilldb","command":"npx","args":["-p","skilldb","skilldb-mcp"]}'

Или добавьте тот же блок сервера в .vscode/mcp.json (workspace) / пользовательский mcp.json в разделе "servers".

После подключения ваш AI‑помощник сможет искать и загружать навыки напрямую. Просто спросите:

"Search SkillDB for React performance patterns"
"Load the code review skill"
"What skills should I use for this project?"
"Save this as a private skill" (Studio план — см. ниже)

10 инструментов: skilldb_search, skilldb_get, skilldb_list, skilldb_suggest, skilldb_recommend, skilldb_purge, skilldb_set_key (установить/заменить API key в середине сессии без перезапуска), и инструменты для приватных навыков skilldb_my_skills, skilldb_create_skill, skilldb_update_skill (Studio план + ключ с областью записи).

Quick Start (CLI)

# Search for skills (with inline preview)
npx skilldb search "code review"

# Install a skill pack
npx skilldb add software-skills

# Activate a smart profile (only loads what you need)
npx skilldb use frontend

# Or auto-detect from your project
npx skilldb use auto

Установка

npm install -g skilldb

Или используйте npx skilldb без установки.

Проблема памяти (И как мы её решаем)

Загрузка 500 навыков в контекст агента хуже, чем загрузка всего нужного набора. SkillDB использует 3‑уровневую архитектуру для эффективного управления:

.skilldb/
├── skills/          ← Полный кэш (всё загружено)
├── active/          ← Активный профиль (то, что видит ваш агент — 5–15 целевых навыков)
├── slim/            ← Сжатые шпаргалки (в 10x меньше)
├── config.json      ← Настройки профиля + бюджета
└── manifest.json    ← Что установлено

Ваш CLAUDE.md или .cursorrules ссылаются на .skilldb/active/, а не на полный кэш. Аgent получает сфокусированные, релевантные навыки — без лишнего.

Команды CLI

Основные

`skilldb init`

Определяет вашу IDE (Claude Code, Cursor, Codex CLI, OpenClaw), создаёт .skilldb/ и добавляет интеграционную конфигурацию.

skilldb init

`skilldb search <query>`

Поиск навыков по ключевому слову. Показывает slim‑preview прямо в выводе, чтобы вы знали, что скачиваете.

skilldb search "debugging"
skilldb search "api design" --category "Technology & Engineering"
skilldb search "testing" --limit 10

`skilldb add <pack>`

Скачать пакет навыков в локальный кэш. Идемпотентно — пропускает уже закэшированные навыки.

skilldb add software-skills
skilldb add autonomous-agent-skills
skilldb add vibe-coding-security-skills

`skilldb get <id>`

Скачать отдельный навык.

skilldb get software-skills/code-review

`skilldb info <id>`

Показать метаданные, короткое резюме и полный предпросмотр навыка.

skilldb info software-skills/code-review

`skilldb list`

Перечень доступных категорий, наборов и навыков.

skilldb list
skilldb list --category "Autonomous Agents"
skilldb list --pack software-skills

`skilldb login`

Запрашивает ваш API key и сохраняет его в ~/.skilldbrc (для всего проекта), чтобы каждый проект получал его через цепочку разрешений в [Authentication]. Лучшее альтернативы ручному выставлению SKILLDB_API_KEY.

skilldb login

Умная загрузка

`skilldb use <profile>`

Активируйте сфокусированный профиль — в .skilldb/active/ загружаются только релевантные навыки.

skilldb use frontend          # React, testing, web-polish, accessibility
skilldb use backend           # API design, databases, security, performance
skilldb use devops            # Kubernetes, Docker, CI/CD, monitoring
skilldb use security          # Trust audit, input validation, credentials
skilldb use data              # SQL, pipelines, analytics, visualization
skilldb use fullstack         # Frontend + backend combined
skilldb use mobile            # Mobile / React Native / app development
skilldb use ai-agent          # Autonomous agent meta-skills
skilldb use auto              # Auto-detect from your project files
skilldb use --list            # Show available profiles
skilldb use --current         # Show active profile
skilldb use none              # Deactivate (clear active/)

режим auto сканирует ваш package.json, расширения файлов и импорты, чтобы порекомендовать подходящий профиль.

`skilldb budget`

Установите максимальный бюджет контекста, чтобы ваш агент не перегружался.

skilldb budget                # Show current usage
skilldb budget set 5000       # Max 5,000 lines
skilldb budget set 50k        # Max 50,000 tokens
skilldb budget optimize       # Re-rank and trim active skills to fit

`skilldb slim`

Сгенерируйте сжатые версии cheat‑sheet‑навыков (~30 строк вместо 300).

skilldb slim                  # Slim all active skills
skilldb slim software-skills  # Slim a specific pack
skilldb slim --ratio 0.3      # Keep 30% of content

Управление

`skilldb update`

Проверка наличия новых версий установленных навыков и их обновление.

skilldb update                # Update everything
skilldb update software-skills  # Update one pack

`skilldb remove`

Удаление навыков из локального кэша.

skilldb remove software-skills/code-review    # Remove single skill
skilldb remove software-skills                # Remove entire pack
skilldb remove --unused                       # Remove skills not in active profile

`skilldb doctor`

Здоровье вашего набора навыков и аудит конфигурации.

skilldb doctor

Показывает: устаревшие навыки, неиспользуемые навыки, отсутствующие зависимости, статус бюджета, пробелы в охвате.

`skilldb stats`

Локальная панель статистики.

skilldb stats

Показывает: количество установленного, общее количество строк, токены, активный профиль, охват категорий.

`skilldb diff <id>`

Сравнить локальную (возможно, кастомную) версию с последним удалённым.

skilldb diff software-skills/code-review
skilldb diff                  # Diff all installed

`skilldb purge`

Удалить кэш‑навыки, чтобы освободить место на диске.

skilldb purge --inactive      # Remove skills not in the active profile
skilldb purge --all           # Remove ALL cached skills (including active)
skilldb purge --slim          # Also drop slim summaries
skilldb purge --dry-run       # Preview what would be removed, delete nothing

Приватные навыки (Studio)

Создавайте навыки, которые могут читать только вы (и люди, с кем вы ими делитесь). Они появятся в ваших результатах поиска, когда вы авторизованы. Создание/редактирование требует Studio план и ключ API со скоупом write — получите его на skilldb.dev/account#api-keys.

`skilldb push <file.md>`

Создать (или обновить) приватный навык из локального Markdown‑файла. Имя навыка по умолчанию соответствует имени файла; заголовок вычисляется как --title → первый Markdown # H1 → имя файла.

skilldb push ./my-react-patterns.md                    # create (pack defaults to "personal")
skilldb push ./my-react-patterns.md -p team --tags react,perf
skilldb push ./my-react-patterns.md --update           # update the skill with the same name/pack

Опции: -p, --pack, -n, --name, -t, --title, -d, --description, --tags <comma,list>, -u, --update.

`skilldb my-skills`

Показать ваши приватные навыки (те, которыми владеете вы, и навыки, которыми с вами делятся).

skilldb my-skills

Вы также можете выполнять всё это из вашего агента через MCP‑инструменты skilldb_create_skill / skilldb_update_skill / skilldb_my_skills.

Совместное использование и экспорт

`skilldb export`

Экспортируйте вашу настройку для совместного использования или интеграции с IDE.

# Print skill to stdout (for piping)

skilldb export claude         # CLAUDE.md snippet with skill references
skilldb export cursor         # .cursorrules block
skilldb export profile        # Shareable .skilldb-profile.json
skilldb export inject <id>    # Print skill to stdout (for piping)

`skilldb recommend`

Сканируйте ваш проект и получите персонализированные рекомендации по навыкам.

skilldb recommend             # Analyze project and suggest
skilldb recommend --install   # Auto-install recommendations

Использование SDK

import { createClient } from 'skilldb';

const db = createClient(); // auto-loads key from env/config

// Search with slim previews
const results = await db.search('code review');
for (const skill of results.skills) {
  console.log(skill.title);
  console.log(skill.slim); // Quick summary
}

// Get full skill content
const skill = await db.get('software-skills/code-review.md');
console.log(skill.content);

// List with filters
const listing = await db.list({ category: 'Autonomous Agents', limit: 10 });

Аутентификация

SDK и CLI ищут ваш API key в порядке:

переменная окружения SKILLDB_API_KEY (для CI)
файл .skilldbrc в корне проекта (для проекта)
файл ~/.skilldbrc в домашнем каталоге (для пользователя)

Уровни доступа:

Без ключа — просмотр и поиск (только метаданные).
Ключ Pro или Studio — полный контент навыков (фактические инструкций в markdown).
Ключ Studio с областью записи (write) — приватные навыки (skilldb push / my-skills, и MCP‑инструменты create/update). Для ключей без права записи отклонение с ошибкой. Получить ключ с правами записи можно на skilldb.dev/account#api-keys.

Профили

Встроенные профили соответствуют курируемым наборам навыков:

Профиль	Загружаемые навыки	Лучшее использование
frontend	react-patterns, web-polish, testing, accessibility	Приложения на React/Vue/Angular
backend	api-design, databases, security, performance	Сервисы Node/Python/Go
devops	kubernetes, docker, ci-cd, monitoring, cloud	Инфраструктура и развёртывание
security	trust-audit, input-validation, credentials, hardening	Обзор безопасности и усиление
data	sql, pipelines, analytics, visualization	Инженерия данных и аналитика
fullstack	frontend + backend combined	Полноценные полностековые приложения
mobile	mobile patterns, app architecture, UI	Мобильные приложения / React Native
ai-agent	autonomous-agent-skills, task-decomposition, planning	Создание агентов ИИ
auto	Определяется автоматически из проекта	Любой проект

Требования

Node.js >= 18

Лицензия

MIT