manage-skills

AI エージェントのスキルを管理する

すべての主要な 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

単一ファイルのツール（設定ファイル1つ）

ツール	グローバルパス	プロジェクトパス
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）では、編集時にファイル全体の内容を置き換えます。
• スキルを作成するときは、ディレクトリ名にケバブケースを使用してください（例：my-new-skill）。