Skill-Cortex（精简版）是一个第三方 MCP（Model Context Protocol）服务器，用于让所有 IDE 获得 Claude Code Skills 的能力。
用途 它作为 IDE 与 Claude Code Skills 之间的桥接层，通过 MCP 协议提供技能发现、索引和检索能力，使非 Claude 环境也能使用基于 SKILL.md 的技能体系。
主要能力
- 技能发现与索引：自动扫描并索引来自多个来源的 SKILL.md 文件。
- 灵活配置：支持自定义技能根目录和缓存路径。
- 标签管理：内置标签验证和管理系统。
- 技能树导航：按类别分层浏览技能。
- 搜索功能：对所有已索引技能进行全文搜索。
- 技能详情：检索每个技能的详细信息。
- 上下文压缩：按 section 提取技能内容，节省 token 消耗。
- 增强导入工具：带配置文件、进度跟踪和错误处理的高级导入脚本。
MCP 工具
- list_skill_tree：以分层树结构浏览技能，参数 path（可选，技能树起始路径）。
- search_skills：按查询文本搜索技能，参数 query（可选）与 tags（可选，用于筛选的标签数组）。
- get_skill_details：获取特定技能详情并支持上下文压缩，参数 skill_id（必填）、section（可选，summary/instructions/examples/full，默认 summary）、max_lines（可选，限制输出行数）。
- update_tags：管理 skills frontmatter 中的 tags，参数 mode（必填，list 或 apply），apply 时需提供 updates。
- create_new_skill：创建新技能并自动验证和索引，参数包括 path（必填）、description（必填，1-1024 字符）、tags、instructions、license、metadata，以及是否创建 scripts/references/assets 目录。技能创建在 .skills/ 目录，名称必须为小写字母和连字符，支持分类路径。
- delete_existing_skill：删除用户创建的技能，参数 skill_id（必填）与 confirm（必填，True 才实际删除）。仅允许删除 .skills/ 目录中的技能，不能删除导入技能（.skills/imported/）或源仓库技能（.skill_cortex_sources/）。
使用方式 先决条件：Python 3.11 或更高版本、pip 包管理器。安装后运行服务器即可通过 MCP 集成使用；技能请放到 ~/.claude/skills 或 ./.skills。
配置 环境变量：
- SKILL_CORTEX_ROOTS：逗号分隔的技能根目录列表，默认 ~/.claude/skills,./.skills。
- SKILL_CORTEX_CACHE_PATH：索引缓存文件路径，默认 ./.skill_cortex_cache/index.json。
- SKILL_CORTEX_TAGS_PATH：允许的标签文件路径，默认 ./tags.md。
导入技能 项目包含增强导入脚本，支持 YAML/JSON 配置文件、自动查找当前目录的 skills-config.yaml、skills-config.yml 或 skills-config.json，也可用 --config 指定自定义配置；支持实时进度、技能计数、汇总报告、出错继续、详细错误报告、错误分类、dry-run 预览等。导入脚本会将技能导入到 ./.skill_cortex_sources/ 并拷贝到 ./.skills/imported/。可导入的公共仓库来源包括 AI 代理技能集合、Anthropic 官方技能仓库、社区策划的 Claude Skills 资源集合、Hugging Face 技能仓库等。
适用场景 适用于希望在任意 IDE 或 CLI 中统一浏览、检索、创建和管理 Claude Code Skills 的开发者；需要按类别浏览技能、全文搜索技能、控制上下文消耗或批量导入公共技能的团队。
限制
- 本仓库默认不内置 skills，需自行放置或通过导入脚本拉取。
- 删除操作有严格范围限制且需要显式确认。
- 标签需在允许的标签文件内且区分大小写。
- 故障排除方面，可能出现模块未找到、技能未显示、标签验证错误、导入脚本错误等情况，需检查配置、缓存与仓库可访问性。
- 许可证为 MIT。
