# Freebuff

Freebuff に Felo Skill をインストールします。Cline と ~/.agents/skills を共有します。

このガイドでは、Freebuff 用の Felo Skill をインストールします。Freebuff には専用の設定ファイルがありません。Cline と同じ共通ディレクトリ `~/.agents/skills` を読み込みます。モデルは Freebuff 本来のモデルのままです。

## 始める前に

- Felo API キー: [作成する](https://openapi.felo.ai/console/api-keys)。
- FeloAPI CLI を使う場合は [Node.js 22 以降](https://nodejs.org/en/download)。
- Freebuff がインストールされていること。

## このガイドで設定する内容

| 項目 | 値 |
| --- | --- |
| モデルプロバイダー | 変更なし（現在お使いの Freebuff モデル） |
| Felo Skill の保存先 | `~/.agents/skills` |
| Felo モデルを使う場合のプロトコル（任意） | OpenAI-compatible |

## 方法 1: Felo Skill をインストールする

```bash
npm install -g feloapi-cli@latest
feloapi setup --agent freebuff --skills-only --yes
```

インストールされるのは Skill のみで、Freebuff のモデルプロバイダーは変更されません。Freebuff のセッションを新規に開始し、`feloapi` Skill を使うよう指示してください。たとえば「feloapi skill を使って今日の AI ニュースを Web 検索し、要約してください」。Freebuff にはモデル／プロバイダーの設定がないため、Cline を設定しても Freebuff を設定しても、同じ共有 Skill が書き込まれます。

## 動作確認

```bash
feloapi doctor --agent freebuff
```

レポートに `freebuff` が `ok: true` として表示されていれば、Skill は正常です。

## 元に戻す / Felo を削除する

現在のモデルプロバイダーは変更されていないため、元に戻す必要はありません。Skill を削除するには:

```bash
feloapi disconnect freebuff --yes
```

## トラブルシューティング

| 問題 | 対処方法 |
| --- | --- |
| `feloapi: command not found` | ターミナルを開き直して再試行してください。`npm install -g feloapi-cli@latest` でインストールできます。 |
| Skill が使われない | Freebuff のセッションを新規に開始してください。Skills は起動時に検出されます。 |
| Skill から Felo を呼び出すときに認証に失敗する | キーを作成して `feloapi auth login` を実行してください（または `FELO_API_KEY` を export します）。 |
| Felo モデルが応答しない | 上記の手動プロバイダー設定を確認してください。Base URL とキーが一致している必要があります。 |

## 関連リンク

- [FeloAPI CLI ガイド](https://openapi.felo.ai/ja/docs/cli.md)
- [モデルと料金](https://openapi.felo.ai/ja/docs/guides/models-and-pricing.md)
- [その他の AI ツール](https://openapi.felo.ai/ja/docs/agent-clients/other-tools.md)