sensecraft-solutions: Skill for Claude Code

Integrate Jetson Solution Skill

Generate a complete solutions/<solution_id>/ package for Jetson deployment, based on structured user input.

This skill is intentionally scoped to:

• local file generation only
• no application source changes
• structured input only (free-form command blocks are not the primary input)

The generated files must conform to the public contract in spec/CONTRACT.md (device schema, docker_deploy derivation, guide.md Step/Target syntax). Validate the result with the offline solutionctl tool (see Execution Workflow).

Inputs Contract

Use the schema in:

• references/input-schema.md

Reject the request if required fields are missing.

Required Validation Rules

1. solution_id must match ^[a-z][a-z0-9_]*$.
2. docker_image must be non-empty and include a repo segment.
3. app_start_command must be non-empty.
4. stream.type must be rtsp or none (default rtsp).
5. camera.mode must be required, optional, or none (default required).
6. If solutions/<solution_id>/ already exists, stop and ask for explicit overwrite permission.

Fixed Decision Logic

1. stream.type=rtsp:

• generate devices/preview.yaml
• include Step 2 (preview) in guide.md and guide_zh.md

1. stream.type=none:

• do not generate devices/preview.yaml
• do not include Step 2 in guides

1. camera.mode=required:

• keep /dev:/dev mount and privileged: true in compose
• guide text says camera is required

1. camera.mode=optional:

• keep /dev:/dev mount and privileged: true in compose
• guide text says camera is optional

1. camera.mode=none:

• remove /dev:/dev mount
• set privileged: false
• guide text says camera is not used

Compose Compatibility (Must Keep)

Use compatibility flow from:

• references/compose-compat.md

The generated devices/jetson.yaml must include a before-action equivalent to:

1. probe docker compose version
2. probe docker-compose --version
3. package fallback: docker-compose-plugin -> docker-compose-v2 -> docker-compose
4. fail with a clear message if unavailable