manage-skills

管理 AI Agent 技能

你可以直接在终端中管理所有主流 AI 编码工具的技能和规则。本技能将介绍各工具的目录布局、文件格式和操作方法。

支持的工具和路径

基于目录的工具（多个技能）

每项技能都存放在独立的子目录中，其中包含一个带有 YAML 前置元数据的 SKILL.md 文件。

工具	全局路径	项目路径
Agents	~/.agents/skills/<name>/SKILL.md	.agents/skills/<name>/SKILL.md
Cursor	~/.cursor/skills/<name>/SKILL.md	.cursor/skills/<name>/SKILL.md
Claude	~/.claude/skills/<name>/SKILL.md	.claude/skills/<name>/SKILL.md
Windsurf	~/.windsurf/rules/<name>/<name>.md	.windsurf/rules/<name>/<name>.md
Cline	~/.cline/rules/<name>/<name>.md	.cline/rules/<name>/<name>.md
Continue	~/.continue/rules/<name>/<name>.md	.continue/rules/<name>/<name>.md
Roo Code	~/.roo/rules/<name>/<name>.md	.roo/rules/<name>/<name>.md

单文件工具（一个配置文件）

工具	全局路径	项目路径
Copilot	~/.github/copilot-instructions.md	.github/copilot-instructions.md
Codex	~/.codex/AGENTS.md	.codex/AGENTS.md
Aider	~/.aider.conf.yml	.aider.conf.yml
Augment	~/augment-guidelines.md	augment-guidelines.md

Cursor 插件（只读）

插件技能缓存在 ~/.cursor/plugins/cache/<org>/<plugin>/<version>/skills/<name>/SKILL.md 中。这些文件由 Cursor 管理，不应直接编辑。

技能文件格式

对于基于目录的工具（Agents、Cursor、Claude），技能使用 YAML 前置元数据：

---
name: skill-name
description: Brief description of what this skill does
---

# Skill Name

Skill instructions go here. The AI agent reads this content
when the skill is activated.

对于 Windsurf、Cline、Continue 和 Roo Code，技能是纯 .md 文件（前置元数据可选）。

操作

列出所有技能

# List skills for a specific tool
ls ~/.agents/skills/
ls ~/.cursor/skills/
ls ~/.claude/skills/
ls ~/.windsurf/rules/
ls ~/.cline/rules/
ls ~/.continue/rules/
ls ~/.roo/rules/

# Count total skills across all tools
echo "Agents: $(ls ~/.agents/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Cursor: $(ls ~/.cursor/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Claude: $(ls ~/.claude/skills/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Windsurf: $(ls ~/.windsurf/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Cline: $(ls ~/.cline/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Continue: $(ls ~/.continue/rules/ 2>/dev/null | wc -l | tr -d ' ')"
echo "Roo: $(ls ~/.roo/rules/ 2>/dev/null | wc -l | tr -d ' ')"

# Check single-file tools
test -f ~/.github/copilot-instructions.md && echo "Copilot: exists" || echo "Copilot: not found"
test -f ~/.codex/AGENTS.md && echo "Codex: exists" || echo "Codex: not found"
test -f ~/.aider.conf.yml && echo "Aider: exists" || echo "Aider: not found"
test -f ~/augment-guidelines.md && echo "Augment: exists" || echo "Augment: not found"

读取技能

cat ~/.cursor/skills/my-skill/SKILL.md

创建新技能

# For Agents/Cursor/Claude (SKILL.md format)
mkdir -p ~/.agents/skills/my-new-skill
cat > ~/.agents/skills/my-new-skill/SKILL.md << 'EOF'
---
name: my-new-skill
description: What this skill does
---

# My New Skill

Instructions for the agent go here.
EOF

# For Windsurf/Cline/Continue/Roo (plain .md format)
mkdir -p ~/.windsurf/rules/my-new-rule
cat > ~/.windsurf/rules/my-new-rule/my-new-rule.md << 'EOF'
# My New Rule

Instructions go here.
EOF

# For single-file tools
cat > .github/copilot-instructions.md << 'EOF'
Instructions for Copilot go here.
EOF

启用 / 禁用技能

禁用技能时，会将文件重命名为 .disabled，使工具忽略它，但保留其内容：

# Disable
mv ~/.cursor/skills/my-skill/SKILL.md ~/.cursor/skills/my-skill/SKILL.md.disabled

# Enable
mv ~/.cursor/skills/my-skill/SKILL.md.disabled ~/.cursor/skills/my-skill/SKILL.md

在工具之间复制技能

# Copy from Cursor to Claude
cp -r ~/.cursor/skills/my-skill ~/.claude/skills/my-skill

# Copy from Agents to Windsurf (adapt format)
mkdir -p ~/.windsurf/rules/my-skill
cp ~/.agents/skills/my-skill/SKILL.md ~/.windsurf/rules/my-skill/my-skill.md

移动技能

mv ~/.cursor/skills/my-skill ~/.agents/skills/my-skill

删除技能

rm -rf ~/.cursor/skills/my-skill

将技能从全局范围复制到项目范围

cp -r ~/.cursor/skills/my-skill .cursor/skills/my-skill

搜索所有技能

# Search by name
find ~/.agents/skills ~/.cursor/skills ~/.claude/skills ~/.windsurf/rules ~/.cline/rules ~/.continue/rules ~/.roo/rules -maxdepth 1 -type d 2>/dev/null | sort

# Search by content
grep -rl "search term" ~/.agents/skills/ ~/.cursor/skills/ ~/.claude/skills/ 2>/dev/null

查找已禁用的技能

find ~/.agents/skills ~/.cursor/skills ~/.claude/skills -name "*.disabled" 2>/dev/null

指南

• 当用户提出“管理技能”“列出我的技能”“创建技能”“将技能复制到 X”或类似请求时，请使用上述路径和格式。
• 删除技能前务必先确认。
• 在格式不同的工具之间复制技能时（例如，从 Cursor 的 SKILL.md 复制到 Windsurf 的纯 .md 文件），请相应调整文件名。
• 项目范围的技能优先于同名的全局技能。
• 对于单文件工具（Copilot、Codex、Aider、Augment），编辑意味着替换整个文件的内容。
• 创建技能时，目录名使用 kebab-case（例如，my-new-skill）。