メインコンテンツへスキップ

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

​
スキルの使用

チャット入力バーで / を入力してスキルコマンドの自動補完を起動します。スキルを選択すると、その内容がメッセージのコンテキストとして注入されます。スキルは入力バーに削除可能なタグとして表示されます。 1つのメッセージで複数のスキルを有効にできます。エージェントはすべてのスキルコンテキストとプロンプトを同時に受け取ります。

​
スキルのスコープ

スキルは2つのレベルで定義できます：
スコープ場所対象
グローバル~/.bricks-project-desktop/skills/すべてのプロジェクト
プロジェクト<project>/.bricks/skills/現在のプロジェクトのみ
プロジェクトスキルとグローバルスキルが同名の場合、プロジェクトスキルが優先されます。

​
スキルの構造

各スキルは次の構造を持つディレクトリです： 
my-skill/
├── SKILL.md          # 必須：メタデータ + 指示
├── rules/            # オプション：追加のルールファイル（.md）
└── references/       # オプション：参照ファイル（.md）

​
SKILL.mdフォーマット

SKILL.md ファイルにはYAML frontmatterとそれに続くmarkdownコンテンツが含まれます： 
---
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スキルリストに表示される短い説明
metadataauthor と version フィールドを持つオブジェクト
licenseライセンスタイプ
allowed-toolsこのスキルが有効な場合にエージェントが使用できるツールのリスト

​
組み込みスキル

CTORはグローバルとプロジェクトの両方のスコープに組み込みスキルを搭載しています。これらはすぐに使用できます。 組み込みグローバルスキルは起動時に自動的に ~/.bricks-project-desktop/skills/ にインストールされます。組み込みスキルを削除しても再インストールされません — スキルパネルから再インストールできます。組み込みスキルはスキルリストに組み込みタグが表示されます。

​
グローバルスキル

クリエイティブな作業の前に行う協調的なデザイン探索。プロジェクトのコンテキストを理解し、明確化の質問をし、トレードオフのある提案をし、実装前に承認を得るようエージェントをガイドします。superpowers から採用。使用タイミング： コーディング前にデザイン探索が必要な機能のアイデアやクリエイティブなタスクがある場合。タスクがすでに明確に定義されている場合は省略できます。
プロジェクトディレクトリの plan/ に保存されるステップバイステップの実装計画を作成します。計画はコードベースのコンテキストがゼロであることを前提とし、ファイルマッピング、テストステップ、検証基準を含む細かいタスクを含みます。superpowers から採用。使用タイミング： 複数ステップのタスクの仕様や要件があり、コードに触れる前に詳細な計画が欲しい場合。
書かれた実装計画を読み込み、批判的にレビューし、すべてのタスクを検証付きで実行し、完了時に報告します。writing-plans スキルで作成した計画と連携します。superpowers から採用。使用タイミング： 書かれた実装計画があり、エージェントにステップバイステップで実行させたい場合。
チャットを通じて新しいスキルを作成するためのガイド。計画から反復までのスキル作成ライフサイクルを教えます — スキルの構造、プログレッシブディスクロージャーデザイン、バンドルリソースをカバーします。スキルの初期化、検証、パッケージングのためのヘルパースクリプトが含まれています。使用タイミング： エージェントの新しいスキルを作成したい場合。
既存のBRICKSアプリケーションから再利用可能なプロンプトテンプレートを抽出します。プロジェクトのデザイン、データフロー、主要機能を分析し、類似のアプリケーションを再作成するためのプロンプトとして使用できる簡潔な5〜10項目の要件リストを平易な言語で作成します。プロセス：
  1. プロジェクトを読む — ビジュアルデザイン、コンポーネント、状態モデル、データフロー、主要な動作を分析します
  2. 重要点を特定する — アプリケーションをその本質的な特徴に蒸留します
  3. テンプレートを書く — 5〜10個の平易な言語の要件番号付きリストを作成します
  4. 提示と改良 — テンプレートが適切になるまで繰り返します
  5. 保存 — 最終テンプレートをプロジェクトルートの template.md に書き込みます
使用タイミング： 既存のBRICKSアプリケーションから再利用可能なテンプレートを抽出したい場合 — 類似プロジェクトの出発点として役立ちます。
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、または既存のネイティブアセットの方が決定論的な出力として優れている場合は省略してください。
BRICKS 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を管理したりする必要がある場合。

​
プロジェクトスキル

bricks-ctor にはBRICKSアプリケーションを構築するためのドメイン知識を持つ組み込みスキルが含まれています：
  • bricks-ctor — アーキテクチャパターン、アニメーション、自動化、データ計算など
  • bricks-design — 独特でポリッシュされたBRICKSインターフェースを構築するためのクリエイティブデザインガイダンス

bricks-ctor 組み込みスキル

bricks-ctorドキュメントの完全なスキルリファレンスを参照してください。

​
スキルのインストール

公開された 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 を含む）の場合は、単一のスキルとして扱われます。

​
選択とインストール

検出されたスキルは名前と説明とともに一覧表示されます。インストールしたい項目を選択するか、Select all / Select none を使用します。次に、フッターでインストールスコープを選びます：
  • Global — ~/.bricks-project-desktop/skills/ にインストール
  • Project — <project>/.bricks/skills/ にインストール（プロジェクトが開かれているときのみ利用可能）
Install (N) をクリックして選択したスキルをインストールします。対象スコープに同名のスキルが既に存在する場合、CTOR は競合を一覧する確認バナーを表示し、上書きを実行する前に確認を求めます。

​
スキルの管理

サイドバーのスキルをクリックしてスキルパネルを開きます。ここから以下ができます：
  • プロジェクトとグローバルスコープを切り替える
  • 利用可能なすべてのスキルとその説明を表示する
  • 各カードのスイッチでスキルを有効化または無効化する
  • スキルの SKILL.md コンテンツを編集する
  • スキルを削除する

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

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

​
ルールと参照

rules/ および references/ サブディレクトリには、メインの SKILL.md コンテンツと一緒に読み込まれる追加のmarkdownファイルを含めることができます：
  • ルール — エージェントへの追加の指示や制約
  • 参照 — 背景知識、APIドキュメント、または例
これらのディレクトリ内のすべての .md ファイルは、スキルが有効化されたときに含まれます。