# 3.3 Skills スキル管理

## 機能説明

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

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

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

## 対応アプリ

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

- **Claude Code**
- **Codex**
- **Gemini CLI**
- **OpenCode**

## Skills ページを開く

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

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

## ページ概要

![image-20260108010253926](../../assets/image-20260108010253926.png)

## スキルの発見

### プリセットリポジトリ

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

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

![image-20260108010308060](../../assets/image-20260108010308060.png)

### 検索とフィルタリング

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

#### 検索ボックス

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

#### ステータスフィルタ

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

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

![image-20260108010324583](../../assets/image-20260108010324583.png)

#### 組み合わせて使用

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

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

### リストの更新

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

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

### 操作手順

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. アンインストールを確認

### アンインストールの効果

- ローカルのスキルフォルダを削除
- インストール状態を更新

## リポジトリ管理

### リポジトリ管理を開く

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

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

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 にアクセスできない
- リポジトリ設定のエラー

解決方法：

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

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

考えられる原因：

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

解決方法：

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