> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# スキル

> AI エージェントのための再利用可能な指示セット

スキルは、AI エージェントにコンテキストとルールを提供する再利用可能な指示ドキュメントです。エージェントが従うべき専門的なワークフロー、コーディングパターン、またはドメイン知識を定義するためにスキルを使用します。

## スキルの使用

チャット入力バーで `/` を入力してスキルコマンドの自動補完を起動します。スキルを選択すると、メッセージに `/skill-name` の参照が挿入され、入力バーに削除可能なタグとして表示されます。

参照は通常のテキストとして送信されます。エージェントはスキルの説明とリクエスト内容に基づいて、参照された各スキルを読み込むかどうかを判断します。

## スキルのスコープ

スキルは2つのレベルで定義できます：

| スコープ       | 場所                                  | 対象          |
| ---------- | ----------------------------------- | ----------- |
| **グローバル**  | `~/.bricks-project-desktop/skills/` | すべてのプロジェクト  |
| **プロジェクト** | `<project>/.bricks/skills/`         | 現在のプロジェクトのみ |

プロジェクトスキルとグローバルスキルが同名の場合、プロジェクトスキルが優先されます。

## スキルの構造

各スキルは次の構造を持つディレクトリです：

```
my-skill/
├── SKILL.md          # 必須：メタデータ + 指示
├── agents/           # オプション：サブエージェント指示ファイル（.md）
├── rules/            # オプション：追加のルールファイル（.md）
└── references/       # オプション：参照ファイル（.md）
```

## SKILL.mdフォーマット

`SKILL.md` ファイルにはYAML frontmatterとそれに続くmarkdownコンテンツが含まれます：

```markdown theme={null}
---
name: my-skill
description: A brief description of what this skill does
metadata:
  author: Your Name
  version: 1.0.0
license: MIT
allowed-tools:
  - read_file
  - write_file
  - edit_file
---

Your skill instructions go here. This content is included
in the agent's context when the skill is activated.

## Rules

- Follow these coding patterns...
- Always use this approach...
```

### Frontmatterフィールド

| フィールド           | 説明                                  |
| --------------- | ----------------------------------- |
| `name`          | スキル名（表示とマッチングに使用）                   |
| `description`   | スキルリストに表示される短い説明                    |
| `metadata`      | `author` と `version` フィールドを持つオブジェクト |
| `license`       | ライセンスタイプ                            |
| `allowed-tools` | このスキルが有効な場合にエージェントが使用できるツールのリスト     |

## 組み込みスキル

CTORはグローバルとプロジェクトの両方のスコープに組み込みスキルを搭載しています。これらはすぐに使用できます。

組み込みグローバルスキルは起動時に自動的に `~/.bricks-project-desktop/skills/` にインストールされます。組み込みスキルを削除しても再インストールされません — スキルパネルから再インストールできます。組み込みスキルはスキルリストに**組み込み**タグが表示されます。

### グローバルスキル

<AccordionGroup>
  <Accordion title="brainstorming" icon="lightbulb">
    クリエイティブな作業の前に行う協調的なデザイン探索。プロジェクトのコンテキストを理解し、明確化の質問をし、トレードオフのある提案をし、実装前に承認を得るようエージェントをガイドします。デザインが確定した後、エージェントは[プランモード](/ja/ctor/reference/plan-mode)に移行して実装プランを作成します。[superpowers](https://github.com/obra/superpowers) から採用。

    **使用タイミング：** コーディング前にデザイン探索が必要な機能のアイデアやクリエイティブなタスクがある場合。タスクがすでに明確に定義されている場合は省略できます。
  </Accordion>

  <Accordion title="skill-creator" icon="hammer">
    チャットを通じて新しいスキルを作成するためのガイド。計画から反復までのスキル作成ライフサイクルを教えます — スキルの構造、プログレッシブディスクロージャーデザイン、バンドルリソースをカバーします。

    スキルの初期化、検証、パッケージングのためのヘルパースクリプトが含まれています。

    **使用タイミング：** エージェントの新しいスキルを作成したい場合。
  </Accordion>

  <Accordion title="template-creator" icon="file-lines">
    既存のBRICKSアプリケーションから再利用可能なプロンプトテンプレートを抽出します。プロジェクトのデザイン、データフロー、主要機能を分析し、類似のアプリケーションを再作成するためのプロンプトとして使用できる簡潔な5〜10項目の要件リストを平易な言語で作成します。

    プロセス：

    1. **プロジェクトを読む** — ビジュアルデザイン、コンポーネント、状態モデル、データフロー、主要な動作を分析します
    2. **重要点を特定する** — アプリケーションをその本質的な特徴に蒸留します
    3. **テンプレートを書く** — 5〜10個の平易な言語の要件番号付きリストを作成します
    4. **提示と改良** — テンプレートが適切になるまで繰り返します
    5. **保存** — 最終テンプレートをプロジェクトルートの `template.md` に書き込みます

    **使用タイミング：** 既存のBRICKSアプリケーションから再利用可能なテンプレートを抽出したい場合 — 類似プロジェクトの出発点として役立ちます。
  </Accordion>

  <Accordion title="imagegen" icon="image">
    CTORで設定された画像プロバイダー（OpenAI `gpt-image-2`、OpenAI Codexバックエンド、またはGemini APIやVertex AI経由のGoogle Nano Banana）を使用して、現在のプロジェクトのラスター画像を生成・編集します。プロバイダー認証情報を解決し、出力をプロジェクト内（デフォルト：`output/imagegen/output.png`）に書き込み、サイズ、品質、アスペクト比、フォーマットのオプションをサポートするバンドルされたBunスクリプトを含みます。

    このスキルは、少なくとも1つの画像対応プロバイダーが設定されている場合にのみ有効になります。`--provider auto` を指定した場合、現在のチャットモデルのプロバイダーが画像生成に対応していればCTORはそれを優先し、対応していない場合は設定済みのデフォルトプロバイダーにフォールバックします。

    **使用タイミング：** 生成されたビットマップアセット（写真、イラスト、テクスチャ、スプライト、モックアップ、プロダクト画像、UIコンセプト）が必要な場合や、既存のラスター画像を編集したい場合。SVG、HTML/CSS、canvas、または既存のネイティブアセットの方が決定論的な出力として優れている場合は省略してください。
  </Accordion>

  <Accordion title="bricks-cli" icon="terminal">
    [BRICKS](https://bricks.tools) CLIツール（`bricks-cli`）のリファレンス。BRICKS Foundation管理、アプリケーションとモジュール操作、Media Flow、LANデバイス探索、ACPブリッジ、MCPサーバー統合をカバーします。

    主な機能：

    * **BRICKS Foundation管理** — デバイスのリスト表示、制御、スクリーンショット、監視
    * **BRICKS Foundationグループ** — コマンドの配布、更新、グループの監視
    * **アプリケーション** — リスト表示、更新、デバイスのバインド、プロジェクトの初期化とデプロイ
    * **モジュール** — リスト表示、更新、プロジェクトの初期化
    * **Media Flow** — メディアボックスの管理、処理オプション付きファイルのアップロード
    * **DevTools** — UDPブロードキャストによるローカルネットワーク上のデバイス探索
    * **MCPサーバー** — ツール統合のためのローカルMCPサーバーを起動
    * **ACPブリッジ** — CTORエージェントとのブリッジ

    **使用タイミング：** BRICKS APIと対話したり、コマンドラインからBRICKS Foundationを管理したりする必要がある場合。
  </Accordion>
</AccordionGroup>

### プロジェクトスキル

bricks-ctor にはBRICKSアプリケーションを構築するためのドメイン知識を持つ組み込みスキルが含まれています：

* **bricks-ctor** — アーキテクチャパターン、アニメーション、自動化、データ計算など
* **bricks-design** — 独特でポリッシュされたBRICKSインターフェースを構築するためのクリエイティブデザインガイダンス

<Card title="bricks-ctor 組み込みスキル" icon="cube" href="/ja/ctor-pkg/skills">
  bricks-ctorドキュメントの完全なスキルリファレンスを参照してください。
</Card>

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

公開された GitHub リポジトリまたはローカルフォルダから、サードパーティのスキルをインストールできます。スキルパネルで **+ Install Skills** をクリックしてインストーラーを開きます。

### GitHub リポジトリから

**GitHub Repository** を選択し、リポジトリの指定を入力します：

* `owner/name` — リポジトリのデフォルトブランチを使用
* `owner/name@branch` — 特定のブランチを指定
* 完全な GitHub URL — `https://github.com/owner/name` または `https://github.com/owner/name/tree/branch`

**Detect** をクリックします。CTOR は対象ブランチの tarball をダウンロードし、`SKILL.md` ファイルを再帰的にスキャンします。

### ローカルフォルダから

**Local Folder** を選択し、**Pick Folder** をクリックしてディレクトリを選び、**Detect** をクリックします。CTOR がフォルダ内の `SKILL.md` ファイルをスキャンします。選択したフォルダ自体がスキル（ルートに `SKILL.md` を含む）の場合は、単一のスキルとして扱われます。

macOS では、**Open Folder in CTOR** Finder Service がこのフローをショートカットします。Finder でフォルダを右クリックして **Services → Open Folder in CTOR** を選ぶと、フォルダが `SKILL.md` ファイルを含むが BRICKS プロジェクトではない場合、CTOR は **Global** スコープでそのフォルダを事前入力したインストーラーを開き、検出されたスキルのリストに直接移動します。

### 選択とインストール

検出されたスキルは名前と説明とともに一覧表示されます。インストールしたい項目を選択するか、**Select all** / **Select none** を使用します。次に、フッターでインストールスコープを選びます：

* **Global** — `~/.bricks-project-desktop/skills/` にインストール
* **Project** — `<project>/.bricks/skills/` にインストール（プロジェクトが開かれているときのみ利用可能）

**Install (N)** をクリックして選択したスキルをインストールします。対象スコープに同名のスキルが既に存在する場合、CTOR は競合を一覧する確認バナーを表示し、上書きを実行する前に確認を求めます。

## スキルの管理

サイドバーの**スキル**をクリックしてスキルパネルを開きます。ここから以下ができます：

* **プロジェクト**と**グローバル**スコープを切り替える
* 利用可能なすべてのスキルとその説明を表示する
* 各カードのスイッチでスキルを有効化または無効化する
* スキルの `SKILL.md` コンテンツを編集する
* スキルを削除する

### スキルの有効化と無効化

各スキルカードには、そのスキルをエージェントのコンテキストに読み込むかどうかを切り替えるスイッチがあります。無効化されたスキルはリストには表示されたままですが、`/` 自動補完を起動したときにスキップされ、エージェントには渡されません。これは組み込みスキルにも適用されます — 組み込みスキル（`imagegen` など）を削除せずに一時的に無効化したい場合にこのスイッチを使用してください。

## ルールと参照

`rules/` および `references/` サブディレクトリには、メインの `SKILL.md` コンテンツと一緒に読み込まれる追加のmarkdownファイルを含めることができます：

* **エージェント** — [サブエージェント](/ja/ctor/reference/sub-agents#instructions-file)の指示ファイル。メインエージェントは`instructions_file`パラメータを通じてこれらを`spawn_agent`に渡し、スキル固有の指示でサブエージェント（通常は`general`）を駆動できます。
* **ルール** — エージェントへの追加の指示や制約
* **参照** — 背景知識、APIドキュメント、または例

`rules/`および`references/`ディレクトリ内のすべての`.md`ファイルは、スキルが有効化されたときに含まれます。`agents/`内のファイルは、`instructions_file`で参照されたときにオンデマンドで読み込まれます。