formatter

Format Python and SQL files with ruff and sqlfluff, skipping generated files.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/GMartin-Data/audit-workspace --skill formatter-gmartin-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: formatter
Source: https://github.com/GMartin-Data/audit-workspace/tree/main/fixtures/perfect-project-cc/.claude/skills/formatter
Command: npx skills add https://github.com/GMartin-Data/audit-workspace --skill formatter-gmartin-data

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually formatting code to match project style guidelines is time-consuming and prone to inconsistency, leading to messy codebases and extra work during code reviews.

Core Features & Use Cases

  • Multi-language formatting: Supports Python files via ruff and SQL files via sqlfluff.
  • Safety guardrails: Automatically skips generated files like migrations and lock files to avoid unintended changes.
  • Post-format validation: Runs the project linter after formatting to catch any remaining style issues.
  • Use Case: You just finished writing a Python data processing script with inconsistent indentation and line lengths; use this skill to automatically align it with your team's style rules in seconds.

Quick Start

Use the formatter skill to clean up the style of the attached Python data analysis script.

Frequently Asked Questions about formatter

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

FAQPage Schema
How do I automatically format Python and SQL code to match project style standards?

To automatically format Python and SQL code, this skill applies ruff to Python files and sqlfluff to SQL files. It enforces project-specific style guidelines and validates the output by running linter checks after formatting.

Can I use ruff and sqlfluff together for pre-commit code formatting?

Yes, you can use ruff and sqlfluff together for pre-commit code formatting. This skill integrates both linters to automatically apply consistent formatting and enforce style rules across your Python and SQL codebases.

What is the best way to format Python scripts without modifying generated files?

The best way to format Python scripts while protecting generated files is using an automated formatter with safety guardrails. This skill skips generated files like migrations and lock files to avoid unintended changes during code cleanup.

Does code formatting run a linter check after applying style changes?

Yes, code formatting runs a linter check after applying style changes. This post-format validation process ensures that any remaining style issues are caught immediately after the initial formatting is applied to your files.

When should I not use automated code formatting on my data processing scripts?

You should not use automated code formatting on generated files or lock files within your data processing scripts. The tool explicitly skips these file types to prevent unintended modifications to auto-generated database migrations.