skills.rest
cjthompson
cjthompsonCOMMUNITY
Explore all skills by this author →
GitHub

python-quality-tools

Format, lint, and type-check standalone Python files using ruff and ty.

1|Updated Feb 25, 2026
Search Tags:#code quality#linting#python#formatting#type checking#ruff#standalone scripts
One-click install
npx skills add https://github.com/cjthompson/claude-code-config --skill python-quality-tools-cjthompson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-quality-tools
Source: https://github.com/cjthompson/claude-code-config/tree/main/plugins/python-scripting/skills/python-quality-tools
Command: npx skills add https://github.com/cjthompson/claude-code-config --skill python-quality-tools-cjthompson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Standalone Python scripts often lack a project toolchain, leaving them without consistent formatting, linting, or type checking. This Skill applies quality checks to those files without forcing you to create a pyproject.toml, package layout, lockfile, or virtual environment. ## Core Features & Use Cases - Standalone File Checks: Runs uvx ruff format, uvx ruff check --fix, and uvx ty check directly on individual Python files. - Toolchain Detection: First determines whether a repository toolchain governs the file, and hands off to python-development:python-project-tooling when it does. - Verification Loop: Reviews formatter changes, then re-runs lint without --fix and re-runs the type checker for clean evidence. - Use Case: You wrote a one-off automation script on macOS with no project setup. Use this Skill to format it, fix lint issues, and confirm type correctness without scaffolding a project. ## Quick Start Format, lint, and type-check my standalone script backup_photos.py without creating any project configuration files.

Frequently Asked Questions about python-quality-tools

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

FAQPage Schema
How do I lint and format a single Python file without a project?▼

Run uvx ruff format followed by uvx ruff check --fix on the file, then uvx ty check for type checking. These commands work directly on standalone files without requiring pyproject.toml or a virtual environment.

What tools check Python code quality for standalone scripts?▼

ruff handles formatting and linting, while ty performs type checking, both invoked via uvx so no installation into the project is needed. Together they cover style, common errors, and type correctness for files outside any repository toolchain.

Should I use ruff on files governed by a repository toolchain?▼

No. When repository configuration, CI, or contributor commands govern the file, defer to the established project tooling instead of standalone defaults. Substituting standalone commands could conflict with the repository's configured rules.

Does checking a standalone Python file require a virtual environment?▼

No. The workflow explicitly avoids creating a virtual environment, pyproject.toml, package layout, or lockfile. The uvx runner executes ruff and ty ephemerally against the target file.

What happens if project tooling is unavailable for a governed file?▼

The unavailable handoff is reported rather than substituting standalone commands. The repository's tools are never changed or bypassed from the standalone workflow.

Related Skills

Explore More Software Engineering Skills→
narumirunanarumiruna
8

python

Automate Python project setup and script execution with uv.

Community
Intermediate
DavidROliverBADavidROliverBA
49

schedule

Schedule recurring vault maintenance tasks via macOS launchd or Linux cron.

Community
Intermediate
jander99jander99
1

python-core

Bootstrap Python 3.10+ projects with structure, tooling, and quality practices.

Community
Advanced
oalansilvaoalansilva

lint-and-validate

Run configured linters and type checkers for Node.js and Python projects.

Community
Advanced