format
Format SQL files using the syntaqlite formatter. Use when the user wants to format, reformat, or pretty-print SQL code.
Best use case
format is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Format SQL files using the syntaqlite formatter. Use when the user wants to format, reformat, or pretty-print SQL code.
Teams using format should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/format/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How format Compares
| Feature / Agent | format | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Format SQL files using the syntaqlite formatter. Use when the user wants to format, reformat, or pretty-print SQL code.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Format SQL Format SQLite SQL using the syntaqlite CLI formatter. ## Usage ```bash # Format a file (print to stdout) syntaqlite fmt query.sql # Format in-place syntaqlite fmt -i query.sql # Format from stdin echo "SELECT a,b FROM t WHERE x=1" | syntaqlite fmt # Format multiple files via glob syntaqlite fmt -i "**/*.sql" # Format with options syntaqlite fmt -w 120 -k upper query.sql ``` ## Options - `-e, --expression <SQL>` — format an inline SQL expression instead of files - `-w, --line-width <N>` — max line width (default: 80) - `-t, --indent-width <N>` — spaces per indentation level (default: 2) - `-k, --keyword-case <upper|lower>` — keyword casing (default: upper) - `-i, --in-place` — overwrite files in place - `--check` — check if files are formatted (exit 1 if not) - `--semicolons <true|false>` — append semicolons (default: true) ## Notes - When the user asks to format a specific file, use `-i` to write in place. - When formatting multiple files, use a glob pattern with `-i`. - Use `--check` in CI to verify formatting without modifying files.
Related Skills
debug-formatter
Debug a SQL formatter bug. Use when the user reports incorrect formatting output — wrong whitespace, misplaced comments, blank lines, etc.
validate
Validate SQL and report diagnostics using syntaqlite. Use when the user wants to check SQL for errors, lint SQL files, or verify correctness against a schema.
parse
Parse SQL and inspect the AST using syntaqlite. Use when the user wants to see the parse tree, debug SQL syntax, or understand how a query is structured.
run-tests
Run tests to verify correctness after code changes. Use when the user asks to run tests, verify changes, or check that things still work. Runs Rust unit tests and integration tests.
run-codegen
Regenerate all generated code from .synq definitions and SQLite grammar. Use when .synq files, grammar actions, or dialect definitions have been modified and generated C/Rust code needs updating.
release
Bump version, commit, tag, and create a draft GitHub Release. Use when the user
cpfast
Quickly commit and push current changes to a feature branch and create a PR, skipping pre-push checks. WARNING: if CI starts failing, use /cp instead.
cp
Commit all current changes, push to a feature branch, and create a PR. Use when the user asks to commit, push, save progress, or ship changes.
dbt-transformation-patterns
Production-ready patterns for dbt (data build tool) including model organization, testing strategies, documentation, and incremental processing.
cloudformation-best-practices
CloudFormation template optimization, nested stacks, drift detection, and production-ready patterns. Use when writing or reviewing CF templates.
information-security-manager-iso27001
Senior Information Security Manager specializing in ISO 27001 and ISO 27002 implementation for HealthTech and MedTech companies. Provides ISMS implementation, cybersecurity risk assessment, security controls management, and compliance oversight. Use for ISMS design, security risk assessments, control implementation, and ISO 27001 certification activities.
information-security-manager-iso27001
ISO 27001 ISMS implementation and cybersecurity governance for HealthTech and MedTech companies. Use for ISMS design, security risk assessment, control implementation, ISO 27001 certification, security audits, incident response, and compliance verification. Covers ISO 27001, ISO 27002, healthcare security, and medical device cybersecurity.