SkillDB

skilldb

面向 SkillDB 的 CLI、TypeScript SDK 和 MCP 服务——发现、安装和管理 AI Agent 技能。

涵盖 429 个技能包中的 5,900 多项专家技能，适用于 Claude Code、Cursor、Windsurf、VS Code，以及任何兼容 MCP 的 AI 工具。

开源，透明可信。 这是 skilldb npm 包的完整源代码——CLI 和 MCP 服务均在你的机器上运行，并处理你的 API 密钥。它通过 Trusted Publishing（OIDC，附带来源证明）发布到 npm，因此发布的构件可验证为由此代码仓库构建。欢迎审查代码，也欢迎提交 PR。采用 MIT 许可证。

MCP 服务

通过模型上下文协议，将 SkillDB 直接连接到你的 AI 编码工具：

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

# Step 2 (optional): Get a Pro or Studio API key for full content at https://skilldb.dev/api-access

# Step 3: Add to Claude Code (omit --api-key for metadata-only access)
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 密钥时，你可以搜索和浏览技能（仅限元数据）。 使用 Pro 或 Studio API 密钥时，你可以获取完整的技能内容——也就是 Agent 使用的实际 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（工作区）或用户的 mcp.json 中的 "servers" 下。

连接后，你的 AI 助手即可原生搜索和加载技能。只需提出以下请求：

• “在 SkillDB 中搜索 React 性能优化模式”
• “加载代码审查技能”
• “这个项目应该使用哪些技能？”
• “将此保存为私有技能”（Studio 套餐——见下文）

提供 10 个工具： skilldb_search、skilldb_get、skilldb_list、skilldb_suggest、skilldb_recommend、skilldb_purge、skilldb_set_key（在会话中设置或替换 API 密钥，无需重启），以及私有技能工具 skilldb_my_skills、skilldb_create_skill、skilldb_update_skill（需 Studio 套餐和具有写入权限的密钥）。

托管 MCP 端点

• 已认证集成： https://skilldb.dev/api/mcp 使用 Streamable HTTP，支持 OAuth 或 SkillDB API 密钥。获取完整技能内容需要 Pro 或 Studio 账户。
• 匿名 SkillDB 目录： https://skilldb.dev/api/mcp/catalog 使用 Streamable HTTP，无需 SkillDB 账户。其两个工具 skilldb_search 和 skilldb_get_preview 仅返回公开元数据和简短预览。它不会获取完整技能内容、安装或执行技能、关联账户，也不会访问私有或团队知识库。

快速开始（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 项技能加载到 Agent 的上下文中，还不如只加载正确的 5 项。SkillDB 使用三层架构来管理：

.skilldb/
├── skills/          ← Full cache (everything downloaded)
├── active/          ← Active profile (what your agent sees — 5-15 focused skills)
├── slim/            ← Compressed cheat sheets (10x smaller)
├── config.json      ← Profile + budget settings
└── manifest.json    ← What's installed

你的 CLAUDE.md 或 .cursorrules 指向 .skilldb/active/，而不是完整缓存。Agent 获取的是精简且相关的技能，而非无关内容。

CLI 命令

核心命令

skilldb init

检测你的 IDE（Claude Code、Cursor、Codex CLI、OpenClaw），创建 .skilldb/，并添加集成配置。

skilldb init

skilldb search <query>

按关键词搜索技能。显示精简的内联预览，让你在下载前了解内容。

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 密钥并将其保存到 ~/.skilldbrc（用户级），以便每个项目都能通过 身份验证 中的解析链获取该密钥。这是手动设置 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

设置上下文预算上限，避免 Agent 不堪重负。

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

生成压缩版技能速查表（约 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 plan，以及具有 write 权限范围的 API 密钥——请在 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，在 Agent 中完成所有这些操作。

分享与导出

skilldb export

导出你的设置，以便分享或集成到 IDE。

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 (requires a configured Pro or Studio API key)
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 密钥：

1. SKILLDB_API_KEY 环境变量（适用于 CI）
2. 项目根目录中的 .skilldbrc（项目级）
3. 主目录中的 ~/.skilldbrc（用户级）

访问权限级别：

• 无密钥——浏览和搜索（仅元数据）。
• Pro 或 Studio 密钥——完整技能内容（实际的 Markdown 指令）。
• 具有 write 权限范围的 Studio 密钥——私有技能（skilldb push / my-skills，以及 create / update MCP 工具）。只读密钥会被拒绝，并返回权限范围错误。请在 skilldb.dev/account#api-keys 创建具有 write 权限范围的密钥。

配置

内置配置映射到精选的技能集：

配置	加载的技能	适用场景
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	构建 AI Agent
auto	根据项目检测	任何项目

要求

• Node.js >= 18

许可证

MIT