brandkit-setup

ツールチェーンをセットアップする

このスキルは4つのステップのうちステップ1です。続いて brandkit-interview、 brandkit-build、brandkit-publish を行います。

最後には、ブランドを練り上げ、正式なブランドキットを作成し、そこからウェブサイト、PDF、AI 生成画像であることを明記した画像を作成できる環境が整います。

相手の言語で話してください。ここにある出力例はドイツ語ですが、指定ではありません。

この順序にする理由

最初に前提条件を確認するのは面倒に思えるかもしれませんが、よくある問題を未然に防げます。スキルのインストールは常に完了してしまい、3つのステップを進めた後になって、Python がなく画像に AI 生成の表示を付けられないことに気づく人がいるからです。確認にかかる時間は20秒です。

ステップ1：前提条件を確認する

次のチェックを実行し、何が揃っていて何が不足しているかを短い表にまとめて報告してください。

node --version        # ab v18, für die Higgsfield CLI und den Design-Canvas
npm --version
python --version      # oder python3, für die Bildkennzeichnung
python -c "import PIL; print(PIL.__version__)"   # Pillow
git --version         # zum Versionieren des Brand Kits
exiftool -ver         # optional, für die maschinenlesbare Bildmarkierung

PDF を印刷するには Chrome または Edge が必要です。Windows では通常 Chrome は C:\Program Files\Google\Chrome\Application\chrome.exe に、macOS では /Applications/Google Chrome.app にあります。

何が何に必要なのかを示し、追加インストールするものを判断できるようにします。

不足しているもの	できなくなること
Node と npm	Higgsfield CLI、スキルのインストール、デザインキャンバス
Python と Pillow	画像への AI 生成表示の追加、ウェブ用の縮小
Chrome または Edge	HTML からの PDF 生成
git	ブランドキットのバージョン管理と共有
exiftool	画像ファイルへの機械可読なマークの追加

Pillow は pip install Pillow でインストールできます。Exiftool は Windows では winget install ExifTool、macOS では brew install exiftool でインストールできます。

ステップ2：4つのスキルをインストールする

2つはグローバルに、2つはプロジェクトにインストールします。この違いは見た目だけのものではありません。グローバルにインストールしたスキルはすべてのプロジェクトで利用できますが、プロジェクトローカルのスキルはそのプロジェクトでのみ利用でき、skills-lock.json を通じてリポジトリに追加されます。

グローバルにインストールします。どのような作業にも使えるためです。

npx skills add cursor/plugins -s unslop -g -y
npx skills add mattpocock/skills -s grill-with-docs,grilling,domain-modeling -g -y

unslop は文章から AI 特有の表現を取り除きます。grill-with-docs はステップ2で使うインタビュースキルです。注意してください。ここでつまずく人が最も多くいます。grill-with-docs は grilling と domain-modeling を呼び出すだけのラッパーです。最初のスキルだけをインストールすると、実行しても何もできないスキルになってしまいます。そのため、コマンドには3つすべてを含めています。

プロジェクトにインストールします。ウェブ関連の作業向けであり、すべてのフォルダーに適しているわけではないためです。

npx skills add vercel-labs/agent-skills -s web-design-guidelines -y
npx skills add coreyhaines31/marketingskills -s seo-audit -y

web-design-guidelines がすでにグローバルに存在する場合はそのことを伝え、プロジェクト版も本当に必要か確認してください。同じスキルの2つの版に違いが生じると、混乱の原因になります。

インストールされたことを確認します。

npx skills list -g      # global
npx skills list         # im Projekt

ステップ3：画像生成のために Higgsfield を接続する

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills -g -y

higgsfield auth login を実行するとブラウザーが開きます。ログインが完了するまでコマンドは終了しません。先に進む前に、確認が完了するのを待ってください。

その後、確認します。

higgsfield account status

出力にはアカウントと残りのクレジットが表示されます。Session expired または Not authenticated と表示された場合は、再度ログインする必要があります。

Higgsfield アカウントをまだ持っていない場合は、画像生成のたびにクレジットが必要なため、クレジット付きのアカウントが必要です。このタイミングで、ここでのみ、次の案内をしてください。

サブスクリプションが必要な場合はこちら：https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR （アフィリエイトリンクです。このリンクから申し込むと、このスキルの作者に紹介料が支払われます。料金は変わりません。）

AI 生成の表示は必要なため、省略しないでください。すでにアカウントを持っている人には、このリンクを表示しません。手順を完了させるためだけに、サブスクリプションを勧めないでください。最初の3つのステップはアカウントがなくても実行できますが、画像生成はできません。

ステップ 4：まとめる

最後に、数行で報告します：

• 満たされている前提条件と、不足している前提条件
• どのスキルがどこにインストールされたか
• Higgsfield に接続されているか、残高はいくらか
• 次のステップ：ブランドインタビュー用の brandkit-interview

失敗したことがあれば、明確に伝え、やり直すための具体的なコマンドを示します。中途半端に設定された環境を完了したと報告すると、今ここで正直に伝えるより、後で時間がかかります。

問題が発生した場合

npx skills add でスキルが見つからない。 リポジトリは大きく、cursor/plugins には八十を超えるスキルがあります。-s <name> の代わりに -l を使うと、何もインストールせずにリポジトリで提供されているものを一覧表示できます。スキルが深い階層のサブフォルダーにあり、表示されない場合は、--full-depth が役立ちます。

インストール後にスキルが表示されない。 スキルの一覧はセッション開始時に読み込まれます。新しくインストールしたスキルが表示されるのは、新しいセッションからです。

higgsfield が見つからない。 グローバル npm ディレクトリがパスに含まれていません。npm bin -g でインストール先を確認できます。