Squix Skill for AI Coding Agents

Execute SQL queries non-interactively with Squix and formatted stdout output.

265|19|Updated Oct 7, 2025
One-click install
npx skills add https://github.com/eduardofuncao/squix --skill squix-skill-for-ai-coding-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Squix Skill for AI Coding Agents
Source: https://github.com/eduardofuncao/squix/tree/main
Command: npx skills add https://github.com/eduardofuncao/squix --skill squix-skill-for-ai-coding-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps AI coding agents execute SQL safely and predictably with Squix, avoiding common interactive/TUI pitfalls and ensuring correct output formatting for automation.

Core Features & Use Cases

  • Non-interactive execution: Enforces the use of -f for SELECT queries so results stream to stdout in machine-friendly formats (json/csv/tsv/html/markdown/sql).
  • Connection safety workflow: Requires checking connectivity (squix status) and switching to the correct connection before running queries.
  • Query library support: Covers running named/ID queries, listing queries/connections, and using parameterized queries with :name and optional defaults (:name|default) for repeatable runs.
  • Operational guardrails: Explicitly lists commands to avoid when you need non-interactive behavior (e.g., squix shell, squix run without -f for SELECT).

Quick Start

Run a previously saved query named orders and stream results as JSON to stdout by giving the command: squix switch <connection-name>, then squix run orders -f json.

Frequently Asked Questions about Squix Skill for AI Coding Agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run SQL queries non-interactively with predictable stdout formatting?

Run SQL queries non-interactively by using the -f flag with SELECT statements to stream results directly to stdout in machine-friendly formats like json, csv, or tsv. This avoids interactive TUI pitfalls and ensures predictable output for automation.

Why does my SQL query execution fail in an automated agent workflow?

SQL query execution fails in automation when using interactive commands like squix shell or omitting the -f flag for SELECT queries. Always check squix status, switch to the target connection, and use -f to force non-interactive output formatting.

What is the best way to execute parameterized queries for repeatable automation runs?

Execute parameterized queries for repeatable automation by using :name syntax with optional defaults like :name|default. This allows AI agents to pass variables dynamically to saved queries, ensuring consistent execution across configured database connections.

Can I use saved query libraries with specific database connections for CLI automation?

Yes, you can use saved query libraries with specific database connections for CLI automation. First switch to the correct connection using squix switch, then run named or ID queries with squix run, applying the -f flag for SELECT exports to format stdout output.

What connection safety workflow is required before executing non-interactive SQL?

Before executing non-interactive SQL, the required connection safety workflow is checking connectivity with squix status and switching to the correct database connection using squix switch. This ensures queries target the intended database and run reliably without interactive prompts.

What are the limitations of using interactive SQL commands in automated pipelines?

The limitations of using interactive SQL commands in automated pipelines include execution failures and unpredictable output. Commands like squix shell or squix run without the -f flag for SELECT queries break automation, requiring strict adherence to non-interactive output formatting rules.