lint-format-typecheck

Runs ruff lint, ruff format, and mypy type checks on Python projects following CI/CD standards.

Updated May 1, 2026
One-click install
npx skills add https://github.com/ricardoo022/4dill --skill lint-format-typecheck-ricardoo022
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lint-format-typecheck
Source: https://github.com/ricardoo022/4dill/tree/main/.gemini/skills/lint-format-typecheck
Command: npx skills add https://github.com/ricardoo022/4dill --skill lint-format-typecheck-ricardoo022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruff, mypy, and includes scripts (resource) and references (resource) components.

What problem does it solve? Manually running and interpreting ruff lint, ruff format, and mypy checks before every commit is repetitive and error-prone, and failures often surface only after pushing to CI. This Skill automates the full quality-check sequence, parses the output, and produces a consolidated report with actionable fixes. ## Core Features & Use Cases - Sequential CI-Aligned Checks: Executes ruff check, ruff format, and mypy in the exact order defined by the project's CI workflow, ensuring local results match pipeline results. - Auto-Fix Support: Applies safe automatic fixes for lint and formatting issues via ruff check --fix and ruff format, leaving only manual type-error corrections. - Structured Quality Report: Generates a pass/fail summary per tool with issue counts and concrete next steps. - Use Case: Before opening a pull request, run the Skill to confirm all three checks pass locally, fix any reported issues, and push with confidence that CI will not fail on linting or typing. ## Quick Start Run the lint-format-typecheck skill to check the code quality of this project and fix any issues found.

Frequently Asked Questions about lint-format-typecheck

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

FAQPage Schema
How do I run ruff and mypy together on a Python project?▼

Run ruff check on src/ and tests/ first, then ruff format --check, then mypy on the main package with --ignore-missing-imports. This Skill executes all three sequentially and reports a combined pass/fail summary.

How to auto-fix ruff lint and formatting issues in Python?▼

Use ruff check --fix to auto-fix roughly 70% of lint issues and ruff format to fix all formatting problems. Mypy type errors cannot be auto-fixed and require manual annotation or type corrections in the source code.

What is the difference between ruff check and ruff format?▼

Ruff check detects logical and style issues like unused variables, import sorting, and naming violations. Ruff format only rewrites code layout such as spacing and line breaks, similar to black, without changing code semantics.

Why does mypy report errors that ruff does not catch?▼

Mypy performs static type analysis, checking type annotations, argument type mismatches, and missing return types, which ruff does not analyze. Ruff focuses on style, imports, and logical patterns rather than type safety.

Why does ruff format pass but CI linting still fails?▼

Formatting and linting are separate checks: ruff format only fixes layout, while ruff check may still report non-auto-fixable issues like naming violations or unused variables. Mypy type errors also fail CI independently of formatting.