# Agent Skills

Luxonis Agent Skills are a set of skills you install into your AI coding agent (Claude Code, Cursor, Codex, and others). Once
installed, your agent knows how to bring a Luxonis OAK camera to a verified working state, turn your idea into a buildable brief,
and generate a runnable proof of concept, all from inside the harness you already use.

They are harness-agnostic: the same skills work across any agent that supports the [Agent
Skills](https://github.com/luxonis/skills) format. You pick your coding tool; the skills adapt.

> **First time with an OAK camera?**
> You don't need to memorize any commands to get started. Install the skills, connect your device, and let the agent guide you, it writes a `DEVICE.md` in your project with everything it verified, plus any updates, improvements, or networking notes flagged during setup.

## When to use them

Reach for Agent Skills when you want to:

 * Set up a brand-new OAK camera without reading through every guide first.
 * Prototype an app quickly by describing what you want in plain language.
 * Debug a slow, broken, or confusing OAK app or device connection.

You keep using your normal coding agent, the skills just give it Luxonis-specific expertise on demand.

## Install

The skills install once and stay available. During install you choose whether to add them globally (available in every project and
across your tools) or per-project (scoped to the current workspace only).

#### Claude Code

```bash
/plugin marketplace add luxonis/skills
/plugin install luxonis@luxonis
/reload-plugins
```

#### Cursor

Add via Settings → Rules → Add Rule → Remote Rule (Github) using `luxonis/skills`.

#### Any other agent

The `npx` installer works with Codex, Gemini CLI, and any other agent that supports the Agent Skills format:

```bash
npx skills@latest add luxonis/skills
```

The installer asks whether to install globally (every tool and project) or into the current project only.

> **Invoking skills**
> Skills are invoked manually by name, e.g. `luxonis-device-setup`. On most harnesses you trigger them with a leading slash, like `/luxonis-device-setup`. Claude Code namespaces them as `/luxonis:luxonis-device-setup`.

## Available skills

| Skill | What it does |
| --- | --- |
| `luxonis-guide` | Points you to the right skill for your situation. Start here if you're not sure. |
| `luxonis-device-setup` | Brings a Luxonis OAK camera to a verified, working state and records the result in `DEVICE.md`. |
| `luxonis-project-interview` | Interviews you about your idea and writes a buildable project brief. |
| `luxonis-build-poc` | Builds a thin, runnable proof of concept from the brief. |
| `luxonis-troubleshoot` | Diagnoses broken, slow, or confusing OAK apps and device setups. |

## Recommended workflow

Run `luxonis-device-setup`. The agent connects to your OAK, verifies it end to end, and writes a `DEVICE.md` capturing what works,
along with any updates or networking notes it hit along the way. You don't need to know
[oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md) commands up front, the skill handles them and documents them for
you.

Run `luxonis-project-interview`. The agent asks about what you want to build and produces a concrete project brief you can build
against. This step and the previous one are interchangeable, do whichever makes sense first.

Run `luxonis-build-poc`. The agent turns the brief into a runnable app. By default this is a [peripheral
app](https://docs.luxonis.com/software-v3/oak-apps.md) that runs on your laptop with the camera connected, but you can also ask it
to build an app that runs fully standalone on the device, with no host needed.

`luxonis-troubleshoot` is available at any point if something breaks.

## Shared context

Reference materials the skills rely on are cached in `~/.luxonis/agent-context/` and reused across runs, so repeated invocations
stay fast and consistent.

## Related

### Skills repository

Browse the source, file issues, and see the full skill definitions.

[Open on GitHub](https://github.com/luxonis/skills)

### oakctl CLI

The command-line tool the device-setup skill uses under the hood to manage OAK4 devices.

[Install oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)

### OAK Examples

Pre-made applications your agent can learn from and adapt.

[Browse examples](https://github.com/luxonis/oak-examples)