Skill Port

⚓ SkillPort

代理技能的SkillOps工具包

SkillOps=大规模验证、管理和交付技能。

  

______________________________________________________________________

为什么选择SkillPort？

完全兼容 代理技能规范.

______________________________________________________________________

特性

验证

对照以下内容检查技能 代理技能规范.

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——先搜索，按需加载：

为什么搜索很重要： 拥有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

它是如何工作的：

1. skillport doc 在AGENTS.md中生成技能表
2. 代理人阅读AGENTS.md以发现可用技能
3. 需要时，代理会运行 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" }
    }
  }
}

______________________________________________________________________

配置

______________________________________________________________________

创造技能

创建一个 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.

看 创建技能指南 最佳实践。

______________________________________________________________________

技能来源

______________________________________________________________________

了解更多

• 配置指南
• 创造技能
• CLI 参考
• 设计理念

______________________________________________________________________

发展

状态： 工作正在进行中。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

______________________________________________________________________

许可证

麻省理工学院