Skills

SenseCraft CLI ist dafür gebaut, von Agenten gesteuert zu werden, und die Brücke dazu ist ein Satz Skills — schlicht SKILL.md-Dateien, die im npm-Paket der CLI ausgeliefert werden. Ein Agent, der sie lesen kann, weiß, was er ausführen soll, welche Auth-Art jede Befehlsfamilie braucht und wann er anhalten und dich fragen muss — ohne dass du Referenzmaterial in den Chat kopierst.

Schritt 1 von Einrichtung sagt: „Starte dein KI-Tool neu, damit alle Skills vollständig geladen sind“ — diese Seite ist das Einbindungs-How-to hinter diesem Satz.

Wo die Skills liegen

Nimm die Quelle, die für dich einfacher ist — das npm-Paket ist maßgeblich:

• Das npm-Paket — liegt nach der Installation bereits auf deinem Rechner: $(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• Das Quell-Repository — skills/ im öffentlichen sensecraft-cli-Repo. Das npm-Paket ist das, was deine installierte CLI tatsächlich lädt; das öffentliche Repo kann dem veröffentlichten Paket voraus sein.

Die Skill-Übersicht

Skill	Zweck
sensecraft-ai	Router — lade diesen zuerst. Routet zum richtigen Domain-Skill und zur richtigen Auth-Art
sensecraft-data	SenseCAP-Geräte / Gruppen / Daten
sensecraft-apps	CodeCraft Hub applications — Publish / Unpublish / Delete
sensecraft-apps/create-app	Unter-Skill von sensecraft-apps: ein fertiges lokales Projekt in eine App verwandeln und danach lokal-first über ein Manifest aktualisieren
sensecraft-models	Modellbibliothek
sensecraft-files	Datei-Upload
sensecraft-devices-cloud	Jetson / Cloud-Kits
sensecraft-recamera	Auswählen und Öffnen für die klassische reCamera

Die Skills sensecraft-train und sensecraft-fleet — sowie der Root-Skill sensecraft-cli im internen Repo — gehören zum internen/Entwicklungs-Build; sie sind nicht im öffentlichen 0.2.x-Paket enthalten.

Der create-app-Unter-Skill

sensecraft-apps/create-app ist ein verschachtelter Unter-Skill: sensecraft-ai leitet an sensecraft-apps weiter (die Application-Plaza- Domäne), und create-app übernimmt den Weg vom Projekt zur App. Er liegt als Ordner in sensecraft-apps/, daher erfasst ihn die Symlink-Schleife oben automatisch — ein zusätzlicher Einrichtungsschritt ist nicht nötig.

Der Skill führt ein sensecraft-app.json-Manifest im Projektstamm als Single Source of Truth. Es merkt sich die App-ID, die zuletzt gepushte Revision und einen Inhalts-Hash: Ein Retry legt kein Duplikat an, und eine spätere Änderung in der Console wird als Drift angezeigt statt still überschrieben. Ohne Git schreibt der Skill zusätzlich zeitgestempelte Snapshots unter .sensecraft/archive/.

Der Ablauf in vier Schritten:

1. Sammeln — Projekt lesen und eine konsolidierte Fragerunde stellen (Scene, BOM, Clone-/Commerce-Flags, Cover).
2. Validieren — das Manifest aus der Vorlage schreiben und den mitgelieferten Validator plus die Offline-Schemas app fields / app blocks ausführen.
3. Anlegen — Bilder und Firmware hochladen und die App in einem Zug mit app create --from-json erstellen (Anlegen ist kein L2).
4. Lokal-first aktualisieren — das Manifest bearbeiten, mit der Remote-App vergleichen (app view --sketch) und nur die geänderten Bereiche nach einer Sammelbestätigung pushen.

Publish, Unpublish und Delete bleiben beim übergeordneten sensecraft-apps-Skill — sie tragen die Declaration-Zustimmung. Klonen ist ein normaler CLI-Befehl (app clone --id <app_id> --yes) und gehört nicht zu diesem Unter-Skill. Der Unter-Skill endet bei einem privaten Entwurf; Veröffentlichen ist ein separater, bestätigter Schritt. create-app ist ab CLI 0.2.1 enthalten — führe sensecraft-cli update aus, wenn der Ordner fehlt. Die vollständige Anleitung steht unter Ein Projekt in eine App verwandeln.

Skills in dein Tool einbinden

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

Öffne entweder das sensecraft-cli-Repository als Workspace (Cursor liest skills/ direkt) oder verlinke die Skill-Ordner per Symlink in dein Cursor-Skills-Verzeichnis (üblicherweise ~/.cursor/skills/ — prüfe in den Einstellungen deiner Cursor-Version den genauen Ort):

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 und andere Hosts

Die Skills sind gewöhnliche SKILL.md-Ordner ohne herstellerspezifische Anweisungen. Findet dein Host Skills automatisch, lege die Ordner einfach in seinen Suchpfad. Wenn nicht, füge skills/sensecraft-ai/SKILL.md plus den Domain-Skill für deine Aufgabe zum Projektkontext hinzu.

Zwei Regeln, die du kennen solltest

• Der Agent muss Shell-Befehle ausführen können. Ein reiner Chat-Host kann die Skills zwar lesen, aber dein Cloud-Konto nicht tatsächlich bedienen — er sollte das sagen, anstatt so zu tun, als ob.
• Starte den Agenten nach dem Einbinden neu, damit die Skills erkannt werden.

Skills werden mit jedem Upgrade aktualisiert

Die Skills liegen im npm-Paket, daher aktualisiert npm install -g @seeed-studio/sensecraft-cli@latest sie zusammen mit der CLI — neue Befehle und neue Regeln kommen mit demselben Upgrade. Wenn du die Ordner per Symlink verlinkt hast, bist du bereits auf dem aktuellen Stand; wenn du sie kopiert hast, kopiere sie nach jedem Upgrade neu (und starte den Agenten neu).

Kehre dann für deine erste Aufgabe zu Einrichtung, Schritt 3 zurück — oder stöbere in den Anwendungsfällen.