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

スキルの使用

チャット入力バーで / を入力してスキルコマンドの自動補完を起動します。スキルを選択すると、メッセージに /skill-name の参照が挿入され、入力バーに削除可能なタグとして表示されます。 参照は通常のテキストとして送信されます。エージェントはスキルの説明とリクエスト内容に基づいて、参照された各スキルを読み込むかどうかを判断します。

スキルのスコープ

スキルは2つのレベルで定義できます: プロジェクトスキルとグローバルスキルが同名の場合、プロジェクトスキルが優先されます。

スキルの構造

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

SKILL.mdフォーマット

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

Frontmatterフィールド

組み込みスキル

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

グローバルスキル

クリエイティブな作業の前に行う協調的なデザイン探索。プロジェクトのコンテキストを理解し、明確化の質問をし、トレードオフのある提案をし、実装前に承認を得るようエージェントをガイドします。デザインが確定した後、エージェントはプランモードに移行して実装プランを作成します。superpowers から採用。使用タイミング: コーディング前にデザイン探索が必要な機能のアイデアやクリエイティブなタスクがある場合。タスクがすでに明確に定義されている場合は省略できます。
チャットを通じて新しいスキルを作成するためのガイド。計画から反復までのスキル作成ライフサイクルを教えます — スキルの構造、プログレッシブディスクロージャーデザイン、バンドルリソースをカバーします。スキルの初期化、検証、パッケージングのためのヘルパースクリプトが含まれています。使用タイミング: エージェントの新しいスキルを作成したい場合。
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を管理したりする必要がある場合。
既存のアプリケーションから再利用可能なプロンプトテンプレートを抽出する機能は、組み込みスキルではなくなりました。代わりにビルトインマーケットプレイスから App Templatesapp-templates)plugin をインストールしてください — app のリリースなしで更新できます。

プロジェクトスキル

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 を含む)の場合は、単一のスキルとして扱われます。 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 コンテンツを編集する
  • スキルを削除する
プラグインからスキルをインストールすることもできます。プラグインでインストールされたスキルには plugin: {name} バッジが付き、あなたが編集した内容は保持されます — 更新によってあなたの変更が上書きされることはありません。

スキルの有効化と無効化

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

ルールと参照

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