format-lint-assistant

Run formatter, linter, and mypy checks in sequence for Python projects.

109|40|Updated Jul 24, 2017
One-click install
npx skills add https://github.com/dmitriiweb/extract-emails --skill format-lint-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: format-lint-assistant
Source: https://github.com/dmitriiweb/extract-emails/tree/main/.codex/skills/format-lint-assistant
Command: npx skills add https://github.com/dmitriiweb/extract-emails --skill format-lint-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Formatting, linting, and type-checking workflows are often executed in the wrong order or without proper dependency management, leading to inconsistent code quality and wasted time.

Core Features & Use Cases

  • Enforces a deterministic quality workflow by applying formatting before linting, ensuring consistent styling across the project.
  • Manages missing dev dependencies via uv and updates pyproject.toml as needed to satisfy mypy stubs or type requirements.
  • Supports end-to-end quality checks for Python projects, including code formatting, static analysis, and type checks in a repeatable, auditable process.

Quick Start

Run make format before linting to apply formatting changes.

Frequently Asked Questions about format-lint-assistant

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

FAQPage Schema
Why does mypy fail after formatting and linting my Python project?

Mypy fails when formatting and linting run in the wrong order, causing inconsistent code quality. Running the formatter before the linter ensures consistent styling across the project and helps catch type issues early.

How do I automate Python formatting, linting, and type checking in the correct sequence?

You can automate project quality checks by running the formatter, linter, and mypy in a deterministic sequence. This workflow applies formatting before linting to enforce consistent styling and catch type issues early in local and CI contexts.

Does this workflow support adding missing dev dependencies for mypy stubs?

Yes, the workflow manages missing dev dependencies using uv add --dev. It updates pyproject.toml as needed to satisfy mypy stubs or type requirements, ensuring reproducible quality checks.

Can I use this automated quality check for Python projects in CI workflows?

Yes, the automated quality check supports Python projects of varying sizes and CI workflows. It provides a repeatable, auditable process for code formatting, static analysis, and type checks in both local and CI contexts.

What is the best way to handle missing type stubs during Python static analysis?

The best way to handle missing type stubs is to manage them via uv add --dev. This updates pyproject.toml to satisfy mypy requirements, ensuring the type checker runs successfully without manual dependency tracking.