OpenParable
Skip to content
← Back to skills

Bootstrap Example

Development
bootstrap-example

Bootstrap Example is an Agent Skill for development published in the luxonis/oak-examples repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Bootstrap an OAK project from an example in oak-examples. Use when the user wants to copy, extract, start, scaffold, or create a host-script or standalone app/project from an existing repository example, especially for oakctl app create handoff or customization.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/luxonis/oak-examples/blob/HEAD/.agents/skills/bootstrap-example/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bootstrap-example, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

  1. 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.
  2. Before selecting an example, run the helper with --print-index to acquire the local checkout path and INDEX.md path. This command uses the current checkout when available; otherwise it shallow-clones https://github.com/luxonis/oak-examples.git into a local cache with --depth 1 from the default branch main:
python3 scripts/bootstrap_from_example.py --print-index
  1. Read the printed index: path and identify candidate examples. The index links are relative to the printed repo: path; resolve those paths locally and read the candidate AGENTS.md files before choosing. Prefer the closest task and hardware match first, then the closest execution shape.
  2. 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.
  3. Run this skill's bundled helper.
python3 scripts/bootstrap_from_example.py <example-path> ./<new-project-dir>
  1. Use --repo /path/to/oak-examples when the user already has a preferred checkout, or when you need to clone into a specific location.
python3 scripts/bootstrap_from_example.py --repo /tmp/oak-examples <example-path> ./<new-project-dir>
  1. Inspect the generated project's AGENTS.md, CLAUDE.md, and LICENSE; confirm they link to ESSENTIAL_KNOWLEDGE.md, any ## Related Examples links use GitHub main URLs, and whether bootstrap copied the repo root license or preserved example-specific license files.
  2. If the copied example includes its own top-level license files or explicit third-party headers, keep those terms instead of assuming Apache-2.0 applies uniformly.
  3. Tell the user where the project was created, that oakapp.toml identifier was changed if present, and that dependencies, hardware compatibility, runtime validation, and final license review still need to be handled separately.

Example

python3 scripts/bootstrap_from_example.py custom-frontend/raw-stream ./raw-stream-app

Available Scripts

  • scripts/bootstrap_from_example.py: finds or shallow-clones oak-examples, prints the local INDEX.md path with --print-index, copies an example into a new project, writes AGENTS.md and CLAUDE.md, copies ESSENTIAL_KNOWLEDGE.md, carries over the repo root LICENSE when the example does not already provide a top-level license file, converts cross-example links to GitHub main URLs, and rewrites oakapp.toml identifiers.

Selection Checklist

  • Task: detection, depth, streaming, frontend, ROS, C++, calibration, measurement, or integration.
  • Hardware: RVC2/RVC4, stereo, ToF, thermal, IMU, autofocus, or multi-device requirements.
  • Mode: host script, standalone OAK App, or both.
  • Shape: minimal scaffold, packaged app, frontend/backend app, ROS workspace, C++ app, or evaluation tool.
  • Inputs/outputs: camera/media input, model choice, visualization, service/API, stream protocol, or dataset/export target.

Safety

  • Never overwrite an existing output directory. Ask the user for a new path instead.
  • Do not edit the source example while bootstrapping unless the user separately asked for repository changes.
  • Do not claim the generated project is runnable until dependencies and hardware requirements are checked.