brand-init について
brand-init は、新規ブランドや旧形式のブランドコンテキスト移行向けに、ディスク上のブランドパッケージを作成します。他のブランドスキルが参照・更新でき、ポートフォリオのレジストリにも登録できます。
主な機能
- 01brand.yaml と assets ディレクトリの作成
- 02ブランド名と一文説明の設定
- 03パッケージ配置モードの選択
- 04ポートフォリオレジストリへの登録
- 05登録済みブランドの一覧表示
活用シーン
- 01新規ブランドのパッケージ初期化
- 02旧形式のブランドコンテキスト移行
- 03複数のブランドパッケージの管理と検索
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cofoundy/ brand-skills --skill brand-initインストール後、Claude Code で/brand-initを入力して読み込まれたか確認します。
同梱ファイルscripts/brand.sh
詳細
ブランド初期化
ブランド用の永続化レイヤーをセットアップします。ディスク上に構造化されたパッケージを作成し、ほかのすべてのブランドスキルが最初に読み込み、内容を書き込む場所にします。ブランドは一時的なチャット出力ではなく、クエリ可能な成果物(brand.yaml)になります。完全な仕様については、../../references/brand-package-spec.md を参照してください。
実行するタイミング
- 新しいブランドを始めるときに、まだパッケージがない場合(
./、./brand/、brands/<slug>/のいずれにもbrand.yamlがない)。 - 既存の
.agents/brand-context.mdを適切なパッケージに移行するとき。
すでにパッケージがある場合は、再初期化しないでください。パッケージを読み込み、該当するスキルを続けてください。
手順
1. 必要な情報を確認する
ひな形の作成に必要な情報だけを尋ねます(詳細な情報の収集は brand-context で行います)。
- ブランド名(必須)
- 一言紹介 — どのようなブランドかを一文で表したもの(想起用の見出し)です。まだわからない場合は空欄にします。
- 保存場所 — モードを選択します。
./brand/— 現在のプロジェクトをブランディングする場合のデフォルトbrands/<slug>/— 複数のブランドを管理するポートフォリオモード<product>/brand/— ブランドが製品リポジトリに属する場合
- ポートフォリオかどうか — 複数のブランドを管理する場合は、このブランドを
brands/registry.yamlに登録します。
2. パッケージのひな形を作成する
バンドルされたスクリプトを実行します(依存関係は不要です)。このスキルのディレクトリを基準とした scripts/brand.sh にあります。
# In Claude Code, ${CLAUDE_SKILL_DIR} expands to this skill's directory. In other
# agents, resolve scripts/brand.sh relative to where this SKILL.md was loaded.
bash ${CLAUDE_SKILL_DIR}/scripts/brand.sh init \
--name "Acme" --one-liner "…" --out brand --date "$(date +%F)" \
--register brands/registry.yaml # omit --register for a single in-situ brand
これにより、<out>/brand.yaml と <out>/assets/ が作成されます。また、--register を指定した場合はレジストリも更新または追加されます。
再現可能な実行が必要な場合は、--date を明示的に指定してください。
3. 次のスキルに引き継ぐ
パッケージを作成したことと、次に行うことをユーザーに伝えます。brand-context を実行してブランドの DNA を context.md にまとめ、その後 naming、brand-strategy などを実行します。それぞれのスキルはこのパッケージに書き込み、brand.yaml 内の対応するフラグを切り替えます。
ポートフォリオのクエリ
# ${CLAUDE_SKILL_DIR} = this skill's directory in Claude Code; elsewhere use scripts/brand.sh
# relative to where this SKILL.md was loaded.
bash ${CLAUDE_SKILL_DIR}/scripts/brand.sh list --registry brands/registry.yaml
# slug · name · one-liner · path · [status]
各パッケージを開かずに、「どのようなブランドがあるか/どこに保存されているか/一言紹介は何か」という質問に答える際に使用します。
ルール
- レジストリは SSOT ファイルであり、エージェントの記憶ではありません。 ブランドの保存場所と一言紹介はデータです。LLM のマシンごとの記憶ではなく、Git で追跡・共有できる
registry.yamlに保存します。 - 空のセクションファイルを先に作成しないでください。 初期化時に作成するのは
brand.yamlとassets/のみです。各スキルは実行時に、それぞれの*.mdを作成します。 - 既存のパッケージを上書きしないでください。 スクリプトは上書きを拒否します。その動作を尊重してください。