Skills

SenseCraft CLI está construida para ser manejada por agentes, y el puente es un conjunto de skills — archivos SKILL.md de texto plano que vienen dentro del paquete npm de la CLI. Un agente que pueda leerlos sabe qué ejecutar, qué tipo de autenticación necesita cada familia de comandos y cuándo detenerse a preguntarte — sin que tengas que pegar material de referencia en el chat.

El paso 1 de Configuración dice «reinicia tu herramienta de IA para asegurarte de que todas las skills se cargan por completo» — esta página es la guía de conexión que hay detrás de esa línea.

Dónde viven las skills

Elige la fuente que te resulte más fácil — el paquete npm es la referencia:

• El paquete npm — ya está en tu máquina después de instalar: $(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• El repositorio de código fuente — skills/ en el repositorio público sensecraft-cli. El paquete npm es lo que carga tu CLI instalada; el repo público puede ir por delante del paquete publicado.

El mapa de skills

Skill	Propósito
sensecraft-ai	Router — carga este primero. Enruta a la skill de dominio correcta y al tipo de autenticación adecuado
sensecraft-data	Dispositivos / grupos / datos de SenseCAP
sensecraft-apps	CodeCraft Hub applications — publish / unpublish / delete
sensecraft-apps/create-app	Sub-skill de sensecraft-apps: convierte un proyecto local terminado en una app y luego lo actualiza local-first mediante un manifiesto
sensecraft-models	Biblioteca de modelos
sensecraft-files	Subida de archivos
sensecraft-devices-cloud	Kits Jetson / en la nube
sensecraft-recamera	Selección y apertura para la reCamera clásica

Las skills sensecraft-train y sensecraft-fleet —y la skill raíz sensecraft-cli del repo interno— pertenecen al build interno/de desarrollo; no están en el paquete público 0.2.x.

La sub-skill create-app

sensecraft-apps/create-app es una sub-skill anidada: sensecraft-ai enruta a sensecraft-apps (el dominio de aplicaciones de CodeCraft Hub), y create-app se ocupa del flujo de proyecto a app. Es una carpeta dentro de sensecraft-apps/, así que el bucle de symlinks de arriba ya la incluye — no hace falta un paso de configuración extra.

La skill mantiene un manifiesto sensecraft-app.json en la raíz del proyecto como única fuente de verdad. Guarda el id de la app, la última revisión publicada y un hash del contenido: un reintento no crea un duplicado, y un cambio posterior en la Consola se muestra como drift en lugar de sobrescribirse en silencio. Sin git, la skill también escribe snapshots con marca de tiempo en .sensecraft/archive/.

El flujo tiene cuatro pasos:

1. Recopilar — leer el proyecto y hacer una única ronda consolidada de preguntas (scene, BOM, flags de clone/commerce, portada).
2. Validar — escribir el manifiesto desde la plantilla y ejecutar el validador incluido más los esquemas offline app fields / app blocks.
3. Crear — subir imágenes y firmware y crear la app de una vez con app create --from-json (crear no es L2).
4. Actualizar local-first — editar el manifiesto, compararlo con la app remota (app view --sketch) y publicar solo las secciones cambiadas tras una confirmación por lote.

Publish, unpublish y delete siguen en la skill padre sensecraft-apps — llevan el consentimiento de declaración. Clonar es un comando normal de la CLI (app clone --id <app_id> --yes), fuera de esta sub-skill. La sub-skill termina en un borrador privado; publicar es un paso aparte y confirmado. create-app llega con la CLI 0.2.1 y posteriores — ejecuta sensecraft-cli update si falta la carpeta. La guía completa está en Convertir un proyecto en una app.

Conéctalas en tu herramienta

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

Puedes abrir el repositorio sensecraft-cli como espacio de trabajo (Cursor lee skills/ directamente) o crear enlaces simbólicos a las carpetas de skills en tu directorio de skills de Cursor (normalmente ~/.cursor/skills/ — consulta los ajustes de tu versión de Cursor para conocer la ubicación exacta):

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 y otros hosts

Las skills son carpetas SKILL.md corrientes, sin instrucciones específicas de ningún proveedor. Si tu host detecta skills automáticamente, coloca las carpetas en su ruta de descubrimiento. Si no, añade skills/sensecraft-ai/SKILL.md más la skill de dominio de tu tarea al contexto del proyecto.

Dos reglas que debes conocer

• El agente debe poder ejecutar comandos de shell. Un host de solo chat puede leer las skills pero no puede operar realmente tu cuenta en la nube — debería decirlo en lugar de fingir.
• Reinicia el agente después de conectarlas para que las skills se detecten.

Las skills viajan con las actualizaciones

Las skills viven dentro del paquete npm, así que npm install -g @seeed-studio/sensecraft-cli@latest las actualiza junto con la CLI — los comandos nuevos y las reglas nuevas llegan en la misma actualización. Si creaste enlaces simbólicos a las carpetas, ya estás al día; si las copiaste, vuelve a copiarlas después de cada actualización (y reinicia el agente).

Después, vuelve a Configuración, paso 3 para tu primera tarea — o explora los casos de uso.