bootstrap-example
Installation
SKILL.md
Bootstrap Example
Use this skill when the user wants to copy, extract, bootstrap, or start an OAK project from an example in oak-examples.
Workflow
- Clarify the target app before choosing an example: task, required hardware, host-script vs standalone mode, UI needs, model/inference needs, streaming/output needs, and whether the user wants the smallest scaffold or closest production-shaped app.
- Before selecting an example, run the helper with
--print-indexto acquire the local checkout path andINDEX.mdpath. This command uses the current checkout when available; otherwise it shallow-cloneshttps://github.com/luxonis/oak-examples.gitinto a local cache with--depth 1from the default branchmain:
python3 scripts/bootstrap_from_example.py --print-index
- Read the printed
index:path and identify candidate examples. The index links are relative to the printedrepo:path; resolve those paths locally and read the candidateAGENTS.mdfiles before choosing. Prefer the closest task and hardware match first, then the closest execution shape. - Choose a new output directory for the generated project. For installable-skill usage, default to a new subdirectory under the user's current working directory, such as
./raw-stream-app; do not write directly into the current directory. The output directory must not already exist. - Run this skill's bundled helper.