code-quality

Lint, format, type-check, and test code with Ruff, Mypy, and Pytest.

3|3|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/shakestzd/htmlgraph --skill code-quality-shakestzd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-quality
Source: https://github.com/shakestzd/htmlgraph/tree/main/packages/claude-plugin/skills/code-quality-skill
Command: npx skills add https://github.com/shakestzd/htmlgraph --skill code-quality-shakestzd

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of maintaining high code standards by automating checks for bugs, style issues, and type errors, preventing technical debt accumulation.

Core Features & Use Cases

  • Automated Linting & Formatting: Uses Ruff to automatically check and fix code style and potential errors.
  • Type Checking: Employs Mypy to ensure type consistency and catch type-related bugs.
  • Testing: Integrates with Pytest to run automated tests, verifying code functionality.
  • Use Case: Before committing code, run this skill to automatically lint, format, type-check, and test your codebase, ensuring only high-quality, error-free code is merged.

Quick Start

Run uv run ruff check --fix, uv run ruff format, uv run mypy src/, and uv run pytest to ensure all code quality checks pass.

Frequently Asked Questions about code-quality

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

FAQPage Schema
How do I automate Python code quality checks before committing?

Automate Python code quality checks by running Ruff for linting and formatting, Mypy for type checking, and Pytest for testing before committing code. This prevents technical debt accumulation by enforcing coding standards automatically.

What is the best way to run linting and type checking together in a Python project?

Run linting and type checking together using Ruff for style enforcement and Mypy for type consistency. Execute `uv run ruff check --fix` and `uv run mypy src/` sequentially to catch and resolve code errors before integration.

Do I need Pytest installed to enforce code health and reliability?

Yes, Pytest is required to verify functional correctness through automated testing. It works alongside Ruff and Mypy to ensure code hygiene, type consistency, and functional accuracy across your software development workflow.

How does Ruff compare to other linting tools for preventing style issues?

Ruff automates linting and formatting to check and fix code style and potential errors rapidly. It integrates with Mypy and Pytest to provide a comprehensive code quality assurance workflow preventing technical debt accumulation.

Why does my Mypy type checking fail when running code quality checks?

Mypy type checking fails when it detects type inconsistencies and type-related bugs in your codebase. Running `uv run mypy src/` enforces type consistency, ensuring variables and functions match their expected type definitions.