一个第三方 MCP 服务器：让所有 IDE 获得 Claude Code Skills 的能力。 A third-party MCP server: Enable all IDEs to access Claude Code Skills capabilities. - Skill Discovery & Indexing / 技能发现与索引: Automatically scan and index SKILL.md files from multiple sources / 自动扫描和索引来自多个来源的 SKILL.md 文件 - Flexible Configuration / 灵活配置: Support for custom skill roots and cache paths / 支持自定义技能根目录和缓存路径 - Tag Management / 标签管理: Built-in
Add this skill
npx mdskills install Sim-xia/skill-cortex-serverWell-architected MCP server providing comprehensive skill indexing, search, and management with context compression
一个第三方 MCP 服务器：让所有 IDE 获得 Claude Code Skills 的能力。
A third-party MCP server: Enable all IDEs to access Claude Code Skills capabilities.
~/.claude/skills or ./.skills / 本仓库默认不内置 skills，请将 skills 放到 ~/.claude/skills 或 ./.skillsskill_cortex_server/
├── skill_cortex/ # Main package / 主包
│ ├── __init__.py # Package initialization / 包初始化
│ ├── server.py # MCP server implementation / MCP 服务器实现
│ ├── models.py # Data models / 数据模型
│ ├── config.py # Configuration management / 配置管理
│ ├── scanner.py # Skill file scanner / 技能文件扫描器
│ ├── index_store.py # Index storage and caching / 索引存储和缓存
│ ├── tags_registry.py # Tag management system / 标签管理系统
│ └── frontmatter.py # Frontmatter parsing / 前置元数据解析
├── config/ # Configuration files / 配置文件
│ └── examples/ # Example configuration files / 示例配置文件
│ ├── skills-config.yaml # YAML configuration example / YAML配置示例
│ └── skills-config.json # JSON configuration example / JSON配置示例
├── .kiro/ # Kiro specs and development files / Kiro规范和开发文件
│ └── specs/ # Feature specifications / 功能规范
├── .skill_cortex_cache/ # Cache directory / 缓存目录
│ └── index.json # Skill index cache / 技能索引缓存
├── .skill_cortex_sources/ # Imported skills source / 导入的技能源
├── .skills/ # Local skills directory / 本地技能目录
│ └── imported/ # Imported skills / 导入的技能
├── import_skills.py # Enhanced skill import script / 增强的技能导入脚本
├── pyproject.toml # Project configuration / 项目配置
├── README.md # This file / 本文件
└── tags.md # Allowed tags list / 允许的标签列表
# Install in editable mode / 以可编辑模式安装
pip install -e .
# Or install from PyPI (when available) / 或从 PyPI 安装（当可用时）
pip install skill-cortex-lite
# Run directly / 直接运行
skill-cortex
# Or use Python module / 或使用 Python 模块
python -m skill_cortex.server
Browse skills in a hierarchical tree structure / 以分层树结构浏览技能
Parameters / 参数:
path (optional): Starting path in the skill tree / 技能树中的起始路径Example / 示例:
{
"path": "coding"
}
Response / 响应: Returns a hierarchical tree of skills with their metadata / 返回包含元数据的分层技能树
Search for skills by query text / 通过查询文本搜索技能
Parameters / 参数:
query (optional): Search query string / 搜索查询字符串tags (optional): Array of tags to filter by / 用于筛选的标签数组Example / 示例:
{
"query": "database",
"tags": ["coding", "data"]
}
Response / 响应: Returns matching skills with their details / 返回匹配的技能及其详细信息
Get detailed information about a specific skill with context compression / 获取特定技能的详细信息，支持上下文压缩
Parameters / 参数:
skill_id (required): Unique identifier of the skill / 技能的唯一标识符section (optional): What to return / 返回内容类型
"summary" (default): Frontmatter + description snapshot (token-friendly) / 仅元数据和描述摘要（节省token）"instructions": Main instructions section only / 仅主要指令部分"examples": Code examples section only / 仅代码示例部分"full": Complete SKILL.md content / 完整内容max_lines (optional): Limit output to N lines / 限制输出行数Example / 示例:
{
"skill_id": "coding/database/query",
"section": "summary"
}
{
"skill_id": "coding/database/query",
"section": "instructions",
"max_lines": 50
}
Response / 响应: Returns skill information based on section parameter / 根据 section 参数返回技能信息
Manage tags inside skills frontmatter / 管理 skills 的 frontmatter tags
Parameters / 参数:
mode (required): "list" or "apply" / 操作模式："list" 或 "apply"updates (optional): required when mode is "apply" / 当 mode 为 "apply" 时需要提供Example / 示例:
{
"mode": "list"
}
{
"mode": "apply",
"updates": [
{"skill_id": "...", "tags": ["python", "mcp"]}
]
}
Response / 响应: Returns the current tags list or operation result / 返回当前标签列表或操作结果
Create a new skill with automatic validation and indexing / 创建新技能并自动验证和索引
Parameters / 参数:
path (required): Skill path (e.g., "coding/python-helper" or "simple-skill") / 技能路径description (required): Skill description (1-1024 characters) / 技能描述（1-1024字符）tags (optional): Array of tags / 标签数组instructions (optional): Custom instructions (if not provided, a template will be generated) / 自定义指令（如未提供则生成模板）license (optional): License information / 许可证信息metadata (optional): Metadata dict (e.g., {"author": "example", "version": "1.0"}) / 元数据字典create_scripts_dir (optional): Whether to create scripts/ directory / 是否创建 scripts/ 目录create_references_dir (optional): Whether to create references/ directory / 是否创建 references/ 目录create_assets_dir (optional): Whether to create assets/ directory / 是否创建 assets/ 目录Example / 示例:
{
"path": "coding/python-helper",
"description": "A helper skill for Python development tasks",
"tags": ["python", "coding", "development"],
"create_scripts_dir": true
}
{
"path": "simple-skill",
"description": "A simple skill example",
"tags": ["example"],
"instructions": "## Instructions\n\nDetailed instructions here...",
"metadata": {"author": "example-user", "version": "1.0"}
}
Response / 响应: Returns creation result with skill path and details / 返回创建结果，包含技能路径和详细信息
Notes / 注意事项:
.skills/ directory / 技能创建在 .skills/ 目录中Delete a user-created skill (requires confirmation) / 删除用户创建的技能（需要确认）
Parameters / 参数:
skill_id (required): Unique identifier of the skill to delete / 要删除的技能的唯一标识符confirm (required): Must be True to actually delete (False shows preview only) / 必须为 True 才能实际删除（False 仅显示预览）Example / 示例:
{
"skill_id": ".skills:coding/python-helper/SKILL.md",
"confirm": false
}
{
"skill_id": ".skills:simple-skill/SKILL.md",
"confirm": true
}
Response / 响应: Returns deletion result or preview information / 返回删除结果或预览信息
Safety Features / 安全特性:
.skills/ directory / 仅允许删除 .skills/ 目录中的技能.skills/imported/) / 无法删除导入的技能.skill_cortex_sources/) / 无法删除源仓库技能confirm=true to execute deletion / 需要显式 confirm=true 才能执行删除SKILL_CORTEX_ROOTS: Comma-separated list of skill root directories / 逗号分隔的技能根目录列表
~/.claude/skills,./.skills / 默认值/path/to/skills1,/path/to/skills2 / 示例SKILL_CORTEX_CACHE_PATH: Path to the index cache file / 索引缓存文件路径
./.skill_cortex_cache/index.json / 默认值/custom/path/cache.json / 示例SKILL_CORTEX_TAGS_PATH: Path to the allowed tags file / 允许的标签文件路径
./tags.md / 默认值/custom/path/tags.md / 示例{
"mcpServers": {
"skill-cortex-lite": {
"command": "skill-cortex",
"args": [],
"env": {
"SKILL_CORTEX_ROOTS": "/Users/username/skills1,/Users/username/skills2",
"SKILL_CORTEX_CACHE_PATH": "/Users/username/.skill_cortex_cache/index.json",
"SKILL_CORTEX_TAGS_PATH": "/Users/username/tags.md"
}
}
}
}
The project includes an enhanced import script with advanced features for importing skills from public repositories / 项目包含一个增强的导入脚本，具有从公共仓库导入技能的高级功能
skills-config.yaml, skills-config.yml, or skills-config.json in current directory / 自动查找当前目录中的配置文件--config option to specify custom configuration file / 使用 --config 选项指定自定义配置文件This repository does not bundle skills by default. Use the import script (optional) to fetch skills from public repositories / 本仓库默认不内置 skills，可使用导入脚本（可选）从公共仓库拉取：
A comprehensive collection of AI agent skills and capabilities / 一个全面的 AI 代理技能和能力集合
Official skills repository from Anthropic / Anthropic 的官方技能仓库
Community-curated collection of Claude Skills resources / 社区策划的Claude Skills资源集合
Hugging Face's skills repository for AI and machine learning / Hugging Face 的 AI 和机器学习技能仓库
# Preview what would be imported (recommended first step) / 预览将要导入的内容（推荐第一步）
python import_skills.py --dry-run
# Actually import the skills / 实际导入技能
python import_skills.py
# Clean import (remove existing skills first) / 清理导入（先删除现有技能）
python import_skills.py --clean
# Use custom configuration file / 使用自定义配置文件
python import_skills.py --config my-config.yaml
# Import only specific repositories / 仅导入特定仓库
python import_skills.py --only anthropics_skills --only agentskills_agentskills
# Skip cloning (use existing local repositories) / 跳过克隆（使用现有本地仓库）
python import_skills.py --no-clone
# Don't update existing repositories / 不更新现有仓库
python import_skills.py --no-update
YAML Configuration (skills-config.yaml):
repositories:
- name: "anthropics_skills"
url: "https://github.com/anthropics/skills.git"
enabled: true
- name: "agentskills_agentskills"
url: "https://github.com/agentskills/agentskills.git"
enabled: true
- name: "composio_awesome_skills"
url: "https://github.com/ComposioHQ/awesome-claude-skills.git"
enabled: true
- name: "huggingface_skills"
url: "https://github.com/huggingface/skills.git"
enabled: true
settings:
incremental: false
validation: false
JSON Configuration (skills-config.json):
{
"repositories": [
{
"name": "anthropics_skills",
"url": "https://github.com/anthropics/skills.git",
"enabled": true
},
{
"name": "agentskills_agentskills",
"url": "https://github.com/agentskills/agentskills.git",
"enabled": true
},
{
"name": "composio_awesome_skills",
"url": "https://github.com/ComposioHQ/awesome-claude-skills.git",
"enabled": true
},
{
"name": "huggingface_skills",
"url": "https://github.com/huggingface/skills.git",
"enabled": true
}
],
"settings": {
"incremental": false,
"validation": false
}
}
Skills are imported to: ./.skill_cortex_sources/ / 技能导入到：./.skill_cortex_sources/
Skills are copied to: ./.skills/imported/ / 技能拷贝到：./.skills/imported/
The import process includes:
Problem / 问题:
ModuleNotFoundError: No module named 'skill_cortex'
Solution / 解决方案: Install the package in editable mode / 以可编辑模式安装包
pip install -e .
Problem / 问题: Skills are not showing up in the tool results / 技能未在工具结果中显示
Solution / 解决方案:
SKILL_CORTEX_ROOTS points to correct directories / 检查 SKILL_CORTEX_ROOTS 是否指向正确的目录SKILL.md files exist in those directories / 验证这些目录中是否存在 SKILL.md 文件Problem / 问题: Tags are being rejected / 标签被拒绝
Solution / 解决方案:
tags.md file for the allowed tags list / 检查 tags.md 文件中的允许标签列表update_tags tool to add missing tags / 使用 update_tags 工具添加缺失的标签Problem / 问题: Import script fails with configuration or repository errors / 导入脚本因配置或仓库错误而失败
Solution / 解决方案:
--dry-run first to preview what will be imported / 首先使用 --dry-run 预览将要导入的内容--no-clone to skip cloning if repositories already exist locally / 如果仓库已存在本地，使用 --no-clone 跳过克隆# Clone the repository / 克隆仓库
git clone
cd skill_cortex_server
# Install in development mode / 以开发模式安装
pip install -e .
# Run all tests / 运行所有测试
pytest
# Run with coverage / 运行并生成覆盖率报告
pytest --cov=skill_cortex
Contributions are welcome! Please feel free to submit a Pull Request / 欢迎贡献！请随时提交 Pull Request
This project is licensed under the MIT License / 本项目采用 MIT 许可证
For questions and support, please open an issue on GitHub / 如有问题和支持需求，请在 GitHub 上提交 issue
Install via CLI
npx mdskills install Sim-xia/skill-cortex-serverSkill-Cortex (Lite) / Skill-Cortex (精简版) is a free, open-source AI agent skill. 一个第三方 MCP 服务器：让所有 IDE 获得 Claude Code Skills 的能力。 A third-party MCP server: Enable all IDEs to access Claude Code Skills capabilities. - Skill Discovery & Indexing / 技能发现与索引: Automatically scan and index SKILL.md files from multiple sources / 自动扫描和索引来自多个来源的 SKILL.md 文件 - Flexible Configuration / 灵活配置: Support for custom skill roots and cache paths / 支持自定义技能根目录和缓存路径 - Tag Management / 标签管理: Built-in
Install Skill-Cortex (Lite) / Skill-Cortex (精简版) with a single command:
npx mdskills install Sim-xia/skill-cortex-serverThis downloads the skill files into your project and your AI agent picks them up automatically.
Skill-Cortex (Lite) / Skill-Cortex (精简版) works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.