CC-Switch/docs/user-manual/ja/3-extensions/3.3-skills.md

3.3 Skills スキル管理

機能説明

Skills は再利用可能な機能拡張で、AI ツールに特定分野の専門的な能力を与えます。

スキルはフォルダ形式で存在し、以下を含みます：

• プロンプトテンプレート
• ツール定義
• サンプルコード

対応アプリ

Skills 機能は以下の 4 つのアプリに対応しています：

• Claude Code
• Codex
• Gemini CLI
• OpenCode

Skills ページを開く

上部ナビゲーションバーの Skills ボタンをクリックします。

注意：Skills ボタンはすべてのアプリモードで表示されます。

ページ概要

スキルの発見

プリセットリポジトリ

CC Switch は以下の GitHub リポジトリをプリセットとして設定しています：

リポジトリ	説明
Anthropic 公式	Anthropic 提供の公式スキル
ComposioHQ	コミュニティが管理するスキルコレクション
コミュニティ精選	厳選された高品質スキル

検索とフィルタリング

CC Switch は強力な検索とフィルタリング機能を提供しています：

検索ボックス

• スキル名で検索
• スキルの説明で検索
• ディレクトリ名で検索
• リアルタイムフィルタリング、入力と同時に検索

ステータスフィルタ

ドロップダウンメニューでインストール状態別にフィルタリング：

オプション	説明
すべて	すべてのスキルを表示
インストール済み	インストール済みのスキルのみ表示
未インストール	未インストールのスキルのみ表示

組み合わせて使用

検索とフィルタリングは組み合わせて使用できます：

• まず「インストール済み」でフィルタリング
• 次にキーワードで検索
• 結果にマッチ数が表示

リストの更新

「更新」ボタンをクリックしてリポジトリを再スキャンし、最新のスキルを取得します。

スキルのインストール

操作手順

1. インストールしたいスキルカードを見つける
2. 「インストール」ボタンをクリック
3. インストール完了を待つ

インストール先

アプリ	インストールディレクトリ
Claude	~/.claude/skills/
Codex	~/.codex/skills/
Gemini	~/.gemini/skills/
OpenCode	~/.opencode/skills/

インストール内容

インストールによりスキルフォルダがローカルにコピーされます：

~/.claude/skills/
└── skill-name/
    ├── README.md
    ├── prompt.md
    └── tools/
        └── ...

スキルのアンインストール

操作手順

1. インストール済みのスキルカードを見つける
2. 「アンインストール」ボタンをクリック
3. アンインストールを確認

アンインストールの効果

• 自動バックアップ：削除前にスキルが ~/.cc-switch/skill-backups/ にバックアップされる
• すべてのアプリディレクトリ（Claude、Codex、Gemini、OpenCode）からスキルを削除
• SSOT ディレクトリ（~/.cc-switch/skills/）からスキルを削除
• データベースからスキルレコードを削除

バックアップから復元

以前アンインストールしたスキルを復元する場合：

1. Skills ページを開く
2. バックアップから復元 ボタンをクリック
3. リスト（スキル名とバックアップ日が表示）から復元したいバックアップを選択
4. スキルが復元され、現在のアプリで有効化される

バックアップの削除

古いスキルバックアップを削除するには：

1. 復元ダイアログで削除したいバックアップを見つける
2. バックアップエントリの横にある 削除 ボタンをクリック
3. 削除を確認（この操作は取り消せません）

リポジトリ管理

リポジトリ管理を開く

ページ上部の「リポジトリ管理」ボタンをクリックします。

カスタムリポジトリの追加

1. 「リポジトリを追加」をクリック
2. リポジトリ情報を入力：
   • Owner：GitHub ユーザー名または組織名
   • Name：リポジトリ名
   • Branch：ブランチ名（デフォルト main）
   • Subdirectory：スキルがあるサブディレクトリ（任意）
3. 「追加」をクリック

リポジトリの形式

https://github.com/{owner}/{name}/tree/{branch}/{subdirectory}

例：

Owner: anthropics
Name: claude-skills
Branch: main
Subdirectory: skills

リポジトリの削除

1. リポジトリリストで削除するリポジトリを見つける
2. 「削除」ボタンをクリック
3. 削除を確認

リポジトリを削除しても、そのリポジトリのスキルはリストから消えませんが、更新はできなくなります。

スキルカードの情報

各スキルカードには以下が表示されます：

情報	説明
名前	スキル名
説明	機能の説明
ソース	所属リポジトリ
ステータス	インストール済み / 未インストール

スキルの更新

現在、自動更新には対応していません。スキルを更新するには：

1. 既存のスキルをアンインストール
2. リストを更新
3. 再度インストール

スキルリストが空の場合

考えられる原因：

• ネットワークの問題で GitHub にアクセスできない
• リポジトリ設定のエラー

解決方法：

• ネットワーク接続を確認
• 「更新」をクリックしてリトライ
• リポジトリ設定を確認

インストールに失敗する場合

考えられる原因：

• ネットワークの問題
• ディスク容量不足
• 権限の問題

解決方法：

• ネットワーク接続を確認
• ディスク容量を確認
• ディレクトリの権限を確認