Skills

SenseCraft CLI is gebouwd om door agents te worden aangestuurd, en de brug daartussen is een set skills — gewone SKILL.md-bestanden die worden meegeleverd in het npm-pakket van de CLI. Een agent die ze kan lezen, weet wat hij moet uitvoeren, welk soort auth elke commandofamilie nodig heeft en wanneer hij moet stoppen en het je vraagt — zonder dat jij referentiemateriaal in de chat hoeft te plakken.

Stap 1 van Instellen zegt “start je AI-tool opnieuw op om er zeker van te zijn dat alle skills volledig geladen zijn” — deze pagina is de how-to voor het koppelen die achter die zin schuilgaat.

Waar de skills staan

Kies de bron die het makkelijkst is — het npm-pakket is leidend:

• Het npm-pakket — staat na de installatie al op je machine: $(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• De bronrepository — skills/ in de openbare sensecraft-cli-repo. Het npm-pakket is wat je geïnstalleerde CLI daadwerkelijk laadt; de openbare repo kan voorlopen op het gepubliceerde pakket.

Overzicht van de skills

Skill	Doel
sensecraft-ai	Router — laad deze eerst. Routeert naar de juiste domein-skill en het juiste soort auth
sensecraft-data	SenseCAP-apparaten / groepen / data
sensecraft-apps	CodeCraft Hub applications — publish / unpublish / delete
sensecraft-apps/create-app	Sub-skill van sensecraft-apps: een afgerond lokaal project omzetten in een app en daarna lokaal-first bijwerken via een manifest
sensecraft-models	Modelbibliotheek
sensecraft-files	Bestandsupload
sensecraft-devices-cloud	Jetson / cloud-kits
sensecraft-recamera	Kiezen en openen voor de klassieke reCamera

De skills sensecraft-train en sensecraft-fleet — en de root-skill sensecraft-cli in de interne repo — horen bij de interne/ontwikkelbuild; ze zitten niet in het openbare 0.2.x-pakket.

De create-app-sub-skill

sensecraft-apps/create-app is een geneste sub-skill: sensecraft-ai routeert naar sensecraft-apps (het CodeCraft Hub-applicatiedomein), en create-app verzorgt de route van project naar app. Het is een map binnen sensecraft-apps/, dus de symlink-loop hierboven pikt hem automatisch op — extra configuratie is niet nodig.

De skill houdt een sensecraft-app.json-manifest in de projectroot bij als enige bron van waarheid. Het onthoudt het app-id, de laatst gepushte revisie en een contenthash: een nieuwe poging maakt geen duplicaat, en een latere wijziging in de Console verschijnt als drift in plaats van stil te worden overschreven. Zonder git schrijft de skill ook tijdgestempelde snapshots onder .sensecraft/archive/.

De workflow heeft vier stappen:

1. Verzamelen — het project lezen en één gebundelde vraagronde stellen (scene, BOM, clone/commerce-flags, cover).
2. Valideren — het manifest uit de template schrijven en de meegeleverde validator plus de offline schema’s app fields / app blocks draaien.
3. Aanmaken — afbeeldingen en firmware uploaden en de app in één keer aanmaken met app create --from-json (aanmaken is geen L2).
4. Lokaal-first bijwerken — het manifest bewerken, met de remote app vergelijken (app view --sketch) en alleen de gewijzigde secties pushen na één gebundelde bevestiging.

Publish, unpublish en delete blijven bij de bovenliggende sensecraft-apps-skill — die dragen de declaration-toestemming. Klonen is een normaal CLI-commando (app clone --id <app_id> --yes), buiten deze sub-skill. De sub-skill stopt bij een privéconcept; publiceren is een aparte, bevestigde stap. create-app wordt meegeleverd met CLI 0.2.1 en later — voer sensecraft-cli update uit als de map ontbreekt. De volledige handleiding staat in Een project omzetten in een app.

Koppel ze aan je tool

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

Open de repository sensecraft-cli als workspace (Cursor leest skills/ direct uit), of maak symlinks naar de skillmappen in je Cursor-skillsmap (meestal ~/.cursor/skills/ — kijk in de instellingen van je Cursor-versie voor de exacte locatie):

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 en andere hosts

De skills zijn gewone SKILL.md-mappen zonder leveranciersspecifieke instructies. Ontdekt je host skills automatisch, zet de mappen dan in zijn discovery-pad. Zo niet, voeg dan skills/sensecraft-ai/SKILL.md plus de domein-skill voor jouw taak toe aan de projectcontext.

Twee regels om te onthouden

• De agent moet shell-commando’s kunnen uitvoeren. Een host die alleen chat aanbiedt, kan de skills wel lezen, maar je cloudaccount niet daadwerkelijk bedienen — hij moet dat zeggen in plaats van doen alsof.
• Herstart de agent na het koppelen, zodat de skills worden opgepakt.

Skills gaan mee met upgrades

De skills staan in het npm-pakket, dus npm install -g @seeed-studio/sensecraft-cli@latest werkt ze samen met de CLI bij — nieuwe commando’s en nieuwe regels komen met dezelfde upgrade binnen. Heb je de mappen via symlinks gekoppeld, dan ben je direct up-to-date; heb je ze gekopieerd, kopieer ze dan na elke upgrade opnieuw (en herstart de agent).

Ga vervolgens terug naar Instellen, stap 3 voor je eerste taak — of blader door de use cases.