> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqlbuild.com/llms.txt
> Use this file to discover all available pages before exploring further.

# skills

> Install SQLBuild skill files for AI coding agents.

# sqb skills

Install or update SQLBuild skill files so AI coding agents (Claude Code, OpenCode, Cursor, etc.) understand your project's framework, syntax, and conventions.

## sqb skills update

Write the packaged SQLBuild skill file to agent-specific locations in your project.

```bash theme={null}
sqb skills update [flags]
```

### Flags

| Flag       | Description                                                                |
| ---------- | -------------------------------------------------------------------------- |
| `--target` | Specify agent targets to install for. Can be passed multiple times.        |
| `--global` | Install to global agent config directories instead of project-local        |
| `--force`  | Overwrite existing skill files even if they were not generated by SQLBuild |

### Targets

Three agent targets are supported:

| Target     | Local path                           | Global path                                   |
| ---------- | ------------------------------------ | --------------------------------------------- |
| `opencode` | `.opencode/skills/sqlbuild/SKILL.md` | `~/.config/opencode/skills/sqlbuild/SKILL.md` |
| `claude`   | `.claude/skills/sqlbuild/SKILL.md`   | `~/.claude/skills/sqlbuild/SKILL.md`          |
| `agents`   | `.agents/skills/sqlbuild/SKILL.md`   | `~/.agents/skills/sqlbuild/SKILL.md`          |

By default, all three targets are installed. Use `--target` to install specific ones:

```bash theme={null}
# Install for all targets (default)
sqb skills update

# Install for Claude Code only
sqb skills update --target claude

# Install for OpenCode and Claude
sqb skills update --target opencode --target claude

# Install globally
sqb skills update --global
```

### Overwrite behavior

Generated skill files include a marker comment. `sqb skills update` will:

* Overwrite files it previously generated (safe to rerun)
* Refuse to overwrite files that were manually created or edited (no marker)
* Overwrite any file when `--force` is passed

### Configuration

Default targets can be set in `sqlbuild_project.toml` so the team shares the same agent config:

```toml theme={null}
[skills]
targets = ["opencode", "claude"]
```

CLI `--target` flags override the TOML config.

### Playground

The playground command automatically runs `sqb skills update` after creating the project, so AI agents are ready to use immediately:

```bash theme={null}
sqb playground waffle-shop
cd waffle-shop
# Agent skill files are already installed
```