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.

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

sqb skills [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, SQLBuild installs agents and claude. OpenCode consumes the shared .agents skill, while Claude requires its .claude copy. The opencode target remains available as an explicit override for installations that require .opencode:

# Install the agents and claude targets (default)
sqb skills

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

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

# Install globally
sqb skills --global

Overwrite behavior

Generated skill files include an ownership marker. sqb skills 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

Normal project commands append a non-blocking notice when an installed, SQLBuild-owned generated skill is stale. The command still runs normally.

Configuration

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

[skills]
targets = ["agents", "claude"]
auto_update = true

CLI --target flags override the TOML config.

Set auto_update = true to refresh stale generated skills during normal project commands. Auto update reads the skill bundled with the installed SQLBuild package and rewrites only files marked as SQLBuild-owned. It never overwrites a custom file or an unowned path collision.

Playground

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

sqb playground waffle-shop
cd waffle-shop
# Agent skill files are already installed

Project Rules skills

sqb skills installs general SQLBuild framework guidance. sqb rules skills generates project-specific guidance from the active Rules, options, thresholds, naming vocabulary, and scoped deviations:

sqb rules skills
sqb rules skills --check

Use --check in CI to detect missing or stale Rules guidance without rewriting files. Rules use the separate sqlbuild-rules skill path and refuse to overwrite divergent or unowned content. See Compiler-integrated Rules and the Rules CLI reference.