⚓ SkillPort
代理技能的SkillOps工具包
SkillOps=大规模验证、管理和交付技能。
______________________________________________________________________
为什么选择SkillPort？
| 当你。.. | SkillPort。.. |
|---|---|
| 使用没有本机技能支持的编码代理 | 通过MCP或CLI提供服务 |
| 构建自己的AI代理 | 提供MCP服务器、CLI和Python库 |
| 拥有50多种技能，需要快速找到合适的技能 | 先搜索后加载(工具搜索工具 图案） |
| 部署前检查技能 | 根据CI中的规范进行验证 |
| 以编程方式管理技能元数据 | 提供 meta 命令 |
| 在GitHub上查找技能 | 安装 add |
完全兼容 代理技能规范.
______________________________________________________________________
特性
验证
对照以下内容检查技能 代理技能规范.
skillport validate # Validate all skills
skillport validate ./skills # Validate specific directory
skillport validate --json # CI-friendly JSON output在遗漏字段、命名问题和规范违规造成问题之前进行捕获。
管理
来自任何来源的完整生命周期管理。
# Add from GitHub (shorthand)
skillport add anthropics/skills skills
# Add from GitHub (full URL)
skillport add https://github.com/anthropics/skills/tree/main/skills
# Add from local path or zip
skillport add ./my-skills
skillport add skills.zip
# Update, list, remove
skillport update # Update all from original sources
skillport list # See installed skills
skillport remove # Uninstall元数据
更新技能元数据，无需手动编辑文件。有助于自动化和保持团队技能的一致性。
skillport meta get # Get metadata value
skillport meta set # Set metadata value
skillport meta unset # Remove metadata key服务
MCP服务器，用于不支持代理技能的客户端。
灵感来自Anthropic 工具搜索工具 pattern——先搜索，按需加载：
| 工具 | 目的 |
|---|---|
search_skills(query) | 按描述查找技能（全文搜索） |
load_skill(skill_id) | 获取完整说明+路径 |
为什么搜索很重要： 拥有50多种技能，提前加载所有内容会消耗上下文并损害准确性。SkillPort仅加载元数据（约100个令牌/技能），然后按需加载完整指令。
适用于Cursor、Copilot、Windsurf、Cline、Codex和任何兼容MCP的客户端。
______________________________________________________________________
快速开始
安装
uv tool install skillport
# or: pip install skillport添加技能
# Add from GitHub
skillport add anthropics/skills skills
# Or use a custom skills directory
skillport --skills-dir .claude/skills add anthropics/skills skills验证
skillport validate
# ✓ All 5 skill(s) pass validation______________________________________________________________________
连接到代理
选择如何向您的AI代理传授技能：
命令行接口命令模式
适用于可以运行shell命令的代理。无需MCP配置。
skillport init # Initialize project
skillport doc # Generate AGENTS.md with skill table
skillport show # Load full instructions for a skill它是如何工作的：
skillport doc在AGENTS.md中生成技能表- 代理人阅读AGENTS.md以发现可用技能
- 需要时，代理会运行
skillport show加载完整指令
MCP模式
适用于MCP兼容客户端。安装服务器：
uv tool install skillport-mcp添加到客户端的配置中：
{
"mcpServers": {
"skillport": {
"command": "uvx",
"args": ["skillport-mcp"],
"env": { "SKILLPORT_SKILLS_DIR": "~/.skillport/skills" }
}
}
}One-click install for popular clients
光标
VS代码/GitHub副本
基罗
CLI代理
# Codex
codex mcp add skillport -- uvx skillport-mcp
# Claude Code
claude mcp add skillport -- uvx skillport-mcp______________________________________________________________________
组织
用类别和标签组织技能。适用于CLI和MCP模式。
类别和标签
使用元数据来组织和过滤技能：
# SKILL.md frontmatter
metadata:
skillport:
category: development
tags: [testing, quality]
alwaysApply: true # Always available (Core Skills)按客户端筛选
向不同的代理人展示不同的技能：
{
"mcpServers": {
"skillport-dev": {
"command": "uvx",
"args": ["skillport-mcp"],
"env": { "SKILLPORT_ENABLED_CATEGORIES": "development,testing" }
},
"skillport-writing": {
"command": "uvx",
"args": ["skillport-mcp"],
"env": { "SKILLPORT_ENABLED_CATEGORIES": "writing,research" }
}
}
}______________________________________________________________________
配置
| 变量 | 描述 | 默认值 |
|---|---|---|
SKILLPORT_SKILLS_DIR | 技能目录 | ~/.skillport/skills |
SKILLPORT_ENABLED_CATEGORIES | 按类别筛选 | 全部 |
SKILLPORT_ENABLED_SKILLS | 按技能ID筛选 | 全部 |
SKILLPORT_ENABLED_NAMESPACES | 按命名空间筛选 | all |
SKILLPORT_CORE_SKILLS_MODE | 核心技能行为(auto/explicit/none) | auto |
______________________________________________________________________
创造技能
创建一个 SKILL.md 使用YAML frontmatter：
---
name: my-skill
description: What this skill does
metadata:
skillport:
category: development
tags: [example]
---
# My Skill
Instructions for the AI agent.看 创建技能指南 最佳实践。
______________________________________________________________________
技能来源
| 源 | 功能 | 目标 | URL |
|---|---|---|---|
| Anthropic Official | 文档技能（docx、pdf、pptx、xlsx）、设计、MCP构建器 | 所有用户 | |
| 精彩的克劳德技能 | 精心策划的社区收藏，2.5k多颗星 | 探索 | |
| 拥抱面部技能 | 数据集创建、模型评估、法学硕士培训、论文发表 | 机器学习/人工智能工程师 | |
| 克劳德科学技能 | 128+科学技能（生物、化学、机器学习），26+数据库 | 研究人员 | |
| ClaudeKit技能 | 30多种技能、身份验证、多模式、问题解决框架 | 全栈开发人员 | |
| 超级能力 | TDD、调试、并行代理、代码审查工作流程 | 注重质量的开发人员 | |
| Kubernetes运维 | K8s部署、监控、故障排查 | DevOps/SRE |
______________________________________________________________________
了解更多
______________________________________________________________________
发展
状态： 工作正在进行中。API可能会发生变化。
git clone https://github.com/gotalab/skillport.git
cd skillport
uv sync
# Run MCP server
SKILLPORT_SKILLS_DIR=.skills uv run skillport-mcp
# Run CLI
uv run skillport --help
# Run tests
uv run pytest______________________________________________________________________
许可证
麻省理工学院