codia-design-skills

Codia Design Skills

これは、Codia Design Skills パックのルートルータースキルです。通常の npx skills add インストールフローでは、エージェントは最初にこのトップレベルスキルを読み込みます。skills/ 配下の機能スキルとワークフロースキルは補助的な指示であり、特定の機能が必要なリクエストに応じて、このルーターが読み込みます。

ローカルの codia-design CLI を通じて Codia を使用してください。CLI は Codia Open API への認証済みリクエストを実行し、コマンドがファイルを返す場合はダウンロードしたファイルをローカルに保存します。

ランタイムのセットアップ

Codia コマンドを実行する前に、CLI が利用可能かどうかを確認してください。

macOS / Linux：

command -v codia-design

Windows PowerShell：

Get-Command codia-design -ErrorAction SilentlyContinue

codia-design が見つからず、ユーザーが npm のグローバルインストールを許可している場合は、ランタイムをインストールしてください。

npm install -g @codia-ai/codia-design-cli

その後、確認してください。

codia-design --help
codia-design auth status

npm のグローバルインストールがブロックされている場合は、同じインストールコマンドを手動で実行するようユーザーに伝え、インストール完了の確認後に続行してください。

認証

課金対象の作業を行う前に、認証状態を確認してください。

codia-design auth status

未接続の場合は、ブラウザログインを優先してください。

codia-design auth login --platform codex

ブラウザログインを利用できず、ユーザーから API キーが提供された場合は、値を表示せずにバインドしてください。

codia-design auth set --api-key api_key_xxx

CLI は認証状態を ~/.codia/design-skills/config.json に保存します。このファイルや API キーを決して表示しないでください。

ルーティングルール

パラメーター、モデルの選択、ポーリング動作、複数ステップの実行順序が必要なコマンドを実行する前に、該当する子スキルを読んでください。パスは、このルートの SKILL.md を基準に解決してください。

ユーザーの意図	読むスキル
Codia の全般的なセットアップ、認証、アカウント確認、フォールバックルーティング	skills/codia-design/SKILL.md
製品ローンチ用パック、EC 出品用アセット、マーケットプレイス用ビジュアル	skills/codia-product-assets/SKILL.md
キャンペーンポスター、ローンチ用ビジュアル、SNS クリエイティブセット、複数サイズへの展開	skills/codia-campaign-assets/SKILL.md
PDF／レポート／ドキュメントを編集可能なデザインデータ、PPTX デッキ、またはその両方に変換	skills/codia-document-deck/SKILL.md
テキストからの画像生成、ポスター、キャンペーン用ビジュアル、背景	skills/codia-image-generate/SKILL.md
1 つ以上の参照画像からの画像生成	skills/codia-image-image-to-image/SKILL.md
既存の画像からの、制御されたビジュアルバリエーションの作成	skills/codia-image-remix/SKILL.md
画像のリフレーム、または新しいアスペクト比への調整	skills/codia-image-reframe/SKILL.md
最終画像のアップスケール、または品質向上	skills/codia-image-upscale/SKILL.md
画像の背景削除、または透明な PNG 切り抜き画像の作成	skills/codia-remove-bg/SKILL.md
背景をスタジオ、ライフスタイル、またはキャンペーンのシーンに置き換え	skills/codia-image-replace-bg/SKILL.md
許可された画像から不要なオブジェクト、雑然とした要素、欠陥を消去	skills/codia-image-object-erase/SKILL.md
許可された画像からウォーターマークやオーバーレイを削除	skills/codia-image-watermark-remove/SKILL.md
画像の説明、確認、キャプション作成、分析	skills/codia-image-describe/SKILL.md
スクリーンショット、UI モックアップ、ポスター、画像を編集可能なデザインデータに変換	skills/codia-image-to-design/SKILL.md
画像を Codia のレイヤリング DSL に変換	skills/codia-image-layering/SKILL.md
選択した PDF ページを編集可能なデザインデータに変換	skills/codia-pdf-to-design/SKILL.md
選択した PDF ページをダウンロード可能な PPTX デッキに変換	skills/codia-pdf-to-ppt/SKILL.md
ロゴ、アイコン、画像を SVG にベクター化	skills/codia-svg/SKILL.md
クレジット残高の確認	skills/codia-credits/SKILL.md
使用記録と最近のタスク費用の確認	skills/codia-usage/SKILL.md
自動チャージ設定の確認または更新	skills/codia-auto-recharge/SKILL.md

ユーザーが複数の成果物を伴う具体的な成果を求めている場合は、ワークフロースキルを優先してください。リクエストが明確な単一の操作である場合は、機能スキルを優先してください。

よくあるワークフローの選択

ユーザーが商品リスト画像セット、商品発売用アセットパック、ストアバナー、白背景の商品タイル、ライフスタイルシーンのバリエーションなど、商品または E コマース向けの成果物を求めている場合は、skills/codia-product-assets/SKILL.md を使用します。

ユーザーがポスターと、それをもとに作成する 1:1、4:5、9:16、バナー、サムネイル版など、キャンペーンまたはソーシャルメディア向けのクリエイティブを求めている場合は、skills/codia-campaign-assets/SKILL.md を使用します。

ユーザーが PDF、レポート、スクリーンショット、既存のデザインファイルを、編集可能なデザインデータ、PPTX デッキ、またはその両方に変換することを求めている場合は、skills/codia-document-deck/SKILL.md を使用します。

コマンドのルール

• ユーザーがローカルアセットを提供した場合は、ローカルファイルパスを優先します。
• 大きな JSON レスポンスには --out を使用します。
• ユーザーが出力先を指定した場合は、--download-dir DIR を使用します。
• ユーザーが JSON のみを明示的に希望した場合に限り、--no-download を使用します。
• PDF の場合、Codia のページ番号は 0 から始まります。ページ 0 が最初のページです。
• pdf-to-ppt では、CLI のポーリング／ダウンロードフローを使用し、返された PPTX を検証します。ユーザーがローカルでの代替手段を明示的に求めていない限り、PDF をローカルでラスタライズしたり、代替のデッキを作成したりしないでください。
• 画像生成では、ユーザーがモデルやサイズを指定していない場合、最初の呼び出しはシンプルにします。CLI のデフォルトは seedream_5、2560x1440 です。
• 透かしやオブジェクトの削除は、画像の所有者がユーザーであるか、その他の方法で許可を得ている場合に限り実行します。

アカウントとコストの確認

CLI は公開 Open API v2 サーフェス（/v2/open/*）を使用し、有料操作の前に課金対象のクレジット費用を見積もります。課金対象のコマンドの後、クレジット残高を確認し、残高が少ない場合は警告を出すことがあります。API 自体がリクエストを拒否しない限り、この警告によって依頼された作業を妨げないでください。

便利なコマンド：

codia-design credits
codia-design usage --page 1 --page_size 20
codia-design limits

出力に関する要件

具体的な結果を報告します。ローカルの出力ファイルパス、ダウンロードした PPTX のパス、画像ファイル、返された URL、タスク ID、API エラーメッセージを含めてください。簡潔な要約で十分な場合は、シークレット、生の認証設定、不要な全量 JSON を含めないでください。