Skills

SenseCraft CLI est conçu pour être piloté par des agents, et le pont entre les deux est un ensemble de skills — de simples fichiers SKILL.md embarqués dans le paquet npm du CLI. Un agent capable de les lire sait quoi exécuter, quel type d’authentification chaque famille de commandes nécessite, et quand s’arrêter pour vous demander — sans que vous ayez à coller de la documentation de référence dans le chat.

L’étape 1 de Installation et configuration indique “redémarrez votre outil IA pour vous assurer que toutes les skills sont bien chargées” — cette page explique comment faire ce branchement.

Où se trouvent les skills

Choisissez la source la plus pratique — le paquet npm fait référence :

• Le paquet npm — déjà présent sur votre machine après l’installation : $(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• Le dépôt source — skills/ dans le dépôt public sensecraft-cli. Le paquet npm est ce que votre CLI installé charge réellement ; le dépôt public peut être en avance sur le paquet publié.

La carte des skills

Skill	Rôle
sensecraft-ai	Routeur — à charger en premier. Aiguille vers la skill de domaine et le type d’authentification appropriés
sensecraft-data	Appareils / groupes / données SenseCAP
sensecraft-apps	CodeCraft Hub applications — publish / unpublish / delete
sensecraft-apps/create-app	Sous-skill de sensecraft-apps : transforme un projet local terminé en application, puis le met à jour en local-first via un manifeste
sensecraft-models	Bibliothèque de modèles
sensecraft-files	Envoi de fichiers
sensecraft-devices-cloud	Kits Jetson / cloud
sensecraft-recamera	Sélection et ouverture pour la reCamera classique

Les skills sensecraft-train et sensecraft-fleet — ainsi que la skill racine sensecraft-cli du dépôt interne — appartiennent au build interne/de développement ; elles ne sont pas dans le paquet public 0.2.x.

Le sous-skill create-app

sensecraft-apps/create-app est un sous-skill imbriqué : sensecraft-ai aiguille vers sensecraft-apps (le domaine des applications CodeCraft Hub), et create-app prend en charge le parcours du projet vers l’application. C’est un dossier dans sensecraft-apps/, donc la boucle de liens symboliques ci-dessus le récupère déjà — aucune étape de configuration supplémentaire n’est nécessaire.

Le skill tient un manifeste sensecraft-app.json à la racine du projet comme source de vérité. Il mémorise l’id de l’application, la dernière révision poussée et un hash du contenu : un nouvel essai ne crée pas de doublon, et une modification ultérieure dans la Console apparaît comme un drift au lieu d’être écrasée en silence. Sans git, le skill écrit aussi des snapshots horodatés sous .sensecraft/archive/.

Le parcours en quatre étapes :

1. Rassembler — lire le projet et poser une seule série de questions consolidée (scene, BOM, options clone/commerce, couverture).
2. Valider — écrire le manifeste depuis le modèle et exécuter le validateur fourni ainsi que les schémas hors ligne app fields / app blocks.
3. Créer — téléverser images et firmware, puis créer l’application en une passe avec app create --from-json (la création n’est pas L2).
4. Mettre à jour en local-first — modifier le manifeste, le comparer à l’application distante (app view --sketch) et ne pousser que les sections modifiées après une confirmation groupée.

Publish, unpublish et delete restent dans le skill parent sensecraft-apps — ils portent le consentement de déclaration. Le clonage est une commande CLI normale (app clone --id <app_id> --yes), hors du périmètre de ce sous-skill. Le sous-skill s’arrête à un brouillon privé ; la publication est une étape séparée et confirmée. create-app est livré avec le CLI 0.2.1 et les suivants — lancez sensecraft-cli update si le dossier manque. Le guide complet se trouve dans Transformer un projet en application.

Les intégrer à votre outil

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

Soit ouvrez le dépôt sensecraft-cli comme espace de travail (Cursor lit skills/ directement), soit créez des liens symboliques vers les dossiers de skills dans votre répertoire de skills Cursor (le plus souvent ~/.cursor/skills/ — consultez les paramètres de votre version de Cursor pour l’emplacement exact) :

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 et autres hôtes

Les skills sont de simples dossiers SKILL.md, sans instructions propres à un outil donné. Si votre hôte découvre les skills automatiquement, déposez les dossiers dans son chemin de découverte. Sinon, ajoutez skills/sensecraft-ai/SKILL.md et la skill de domaine correspondant à votre tâche au contexte du projet.

Deux règles à connaître

• L’agent doit pouvoir exécuter des commandes shell. Un hôte limité au chat peut lire les skills, mais ne peut pas réellement opérer votre compte cloud — il devrait le dire plutôt que de faire semblant.
• Redémarrez l’agent après le branchement pour que les skills soient prises en compte.

Les skills suivent les mises à jour

Les skills vivent dans le paquet npm : npm install -g @seeed-studio/sensecraft-cli@latest les met donc à jour en même temps que le CLI — les nouvelles commandes et les nouvelles règles arrivent avec la même mise à jour. Si vous avez créé des liens symboliques vers les dossiers, vous êtes déjà à jour ; si vous les avez copiés, recopiez-les après chaque mise à jour (et redémarrez l’agent).

Retournez ensuite à Installation et configuration, étape 3 pour votre première tâche — ou parcourez les cas d’utilisation.