スキル

SenseCraft CLI はエージェントに駆動されることを前提に設計されており、その橋渡しとなるのがスキルのセットです —— CLI の npm パッケージ内に同梱された、ごく普通の SKILL.md ファイル群です。これらを読めるエージェントは、何を実行すべきか、各コマンドファミリーがどの認証 kind を必要とするか、そしていつ停止してあなたに尋ねるべきかを理解します —— リファレンス資料をチャットに貼り付ける必要はありません。

セットアップのステップ 1 には「すべてのスキルが完全に読み込まれるよう、AI ツールを再起動してください」とあります —— このページは、その一文の裏側にある組み込み手順です。

スキルの保存場所

どちらか扱いやすい方を選んでください —— npm パッケージが正式です：

• npm パッケージ —— インストール後なら、すでにマシン上にあります： $(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• ソースリポジトリ —— 公開 sensecraft-cli リポジトリの skills/。npm パッケージはインストール済み CLI が実際に読み込むもので、公開リポジトリは公開パッケージより先行することがあります。

スキルマップ

スキル	役割
sensecraft-ai	ルーター —— 最初に読み込むのはこれです。 適切なドメインスキルと認証 kind へ振り分けます
sensecraft-data	SenseCAP デバイス / グループ / データ
sensecraft-apps	CodeCraft Hub applications —— publish / unpublish / delete
sensecraft-apps/create-app	sensecraft-apps のサブスキル：完成したローカルプロジェクトをアプリ化し、その後はマニフェストでローカル優先の更新を行う
sensecraft-models	モデルライブラリ
sensecraft-files	ファイルアップロード
sensecraft-devices-cloud	Jetson / クラウドキット
sensecraft-recamera	クラシック reCamera の選択とオープン

sensecraft-train と sensecraft-fleet スキル、および内部リポジトリの ルート sensecraft-cli スキルは内部/開発ビルド向けで、公開 0.2.x パッケージには含まれません。

create-app サブスキル

sensecraft-apps/create-app はネストされたサブスキルです：sensecraft-ai が sensecraft-apps（CodeCraft Hub アプリケーションのドメイン）へ振り分け、create-app がプロジェクトからアプリへの流れを担当します。sensecraft-apps/ 内のフォルダなので、上のシンボリックリンクのループが自動的に拾います —— 追加の設定は不要です。

このスキルはプロジェクトルートの sensecraft-app.json マニフェストを唯一の情報源として保持します。アプリ ID、最後にプッシュしたリビジョン、内容のハッシュを記録するため、再試行で重複を作らず、後から Console で変更された場合は黙って上書きせず drift として表示します。git がない場合は .sensecraft/archive/ にタイムスタンプ付きスナップショットも書き込みます。

流れは 4 ステップです：

1. 収集 — プロジェクトを読み、1 回のまとめた質問ラウンドを行う（scene、BOM、clone/commerce フラグ、カバー）。
2. 検証 — テンプレートからマニフェストを書き、同梱のバリデータとオフラインスキーマ app fields / app blocks を実行する。
3. 作成 — 画像とファームウェアをアップロードし、app create --from-json で一度にアプリを作成する（作成は L2 ではありません）。
4. ローカル優先で更新 — マニフェストを編集し、リモートアプリと比較して（app view --sketch）、まとめた確認の後に変更されたセクションだけをプッシュする。

Publish、unpublish、delete は親の sensecraft-apps スキルに残ります —— 宣言の同意を伴うためです。クローンは通常の CLI コマンド（app clone --id <app_id> --yes）で、このサブスキルの担当外です。サブスキルは非公開ドラフトで止まり、公開は別の確認済みステップです。create-app は CLI 0.2.1 以降に同梱されます —— フォルダがない場合は sensecraft-cli update を実行してください。詳しい手順はプロジェクトをアプリにするを参照してください。

ツールへの組み込み

Claude Code

bash

  # project-level (recommended — travels with the repo)
mkdir -p .claude/skills
for d in "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"/*; do
  ln -s "$d" ".claude/skills/$(basename "$d")"
done

  # or user-level
mkdir -p ~/.claude/skills
ln -s "$(npm root -g)/@seeed-studio/sensecraft-cli/skills/sensecraft-ai" ~/.claude/skills/sensecraft-ai

Cursor

sensecraft-cli リポジトリをワークスペースとして開く（Cursor は skills/ を直接読み取ります）か、スキルフォルダを Cursor のスキルディレクトリ（通常は ~/.cursor/skills/ —— 正確な場所はお使いの Cursor バージョンの設定で確認してください）にシンボリックリンクしてください：

bash

mkdir -p ~/.cursor/skills
for d in "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"/*; do
  ln -s "$d" ~/.cursor/skills/"$(basename "$d")"
done

Codex、opencode、pi、その他のホスト

これらのスキルは、ベンダー固有の指示を含まない、ごく普通の SKILL.md フォルダです。お使いのホストがスキルを自動検出するなら、その検出パスにフォルダを置くだけです。自動検出しない場合は、skills/sensecraft-ai/SKILL.md と、タスクに応じたドメインスキルをプロジェクトコンテキストに追加してください。

知っておくべき 2 つのルール

• エージェントはシェルコマンドを実行できなければなりません。 チャット専用のホストはスキルを読むことはできても、実際にクラウドアカウントを操作することはできません —— できないのにできるふりをするのではなく、その旨を伝えるべきです。
• 組み込み後はエージェントを再起動して、スキルが読み込まれるようにしてください。

スキルはアップグレードとともに更新される

スキルは npm パッケージの中に存在するため、npm install -g @seeed-studio/sensecraft-cli@latest は CLI と合わせてスキルも更新します —— 新しいコマンドと新しいルールが、同じアップグレードで届きます。フォルダをシンボリックリンクしているなら、常に最新の状態です。コピーしている場合は、アップグレードのたびに再コピーしてください（そのうえでエージェントを再起動します）。

準備ができたら セットアップのステップ 3 に戻って最初のタスクを実行するか、ユースケースを眺めてみてください。