manage-skills

用途

manage-skills 用于在终端中集中管理主流 AI 编程工具的本地 AI Agent 技能与规则文件。当使用者希望检查、创建、编辑、启用、禁用、复制、移动或删除受支持工具的技能或规则文件时，可以使用该技能。它本身是一套目录布局、文件格式与操作方式的说明，帮助使用者按各工具约定的路径与格式完成技能管理。

支持的工具与路径

此类工具中，每个技能位于独立子目录，内含带有 YAML frontmatter 的 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 frontmatter：

---
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 文件（frontmatter 可选）。

操作

列出全部技能

# 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）。

限制

仅当任务明确匹配上述范围时使用该技能。
不要把其输出当作特定环境验证、测试或专家评审的替代。
如果缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。

技能介绍

用途