following-conventions

Enforce Python coding conventions and uv-based quality checks for Tenzir projects.

2|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tenzir/claude-plugins --skill following-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: following-conventions
Source: https://github.com/tenzir/claude-plugins/tree/main/plugins/python/skills/following-conventions
Command: npx skills add https://github.com/tenzir/claude-plugins --skill following-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes coding conventions and tooling setup for Python projects at Tenzir to ensure consistent quality, readability, and reliable builds.

Core Features & Use Cases

  • Required Tools: uv — Dependency management and virtual environments; Ruff; Mypy; pytest
  • Quality Gates: pre-commit style checks; chained commands: uv run ruff check && uv run ruff format --check && uv run mypy && uv run pytest && uv build
  • Python Version & Style: Python 3.12+; typing; naming conventions; CLI conventions; documentation style
  • Project Setup: docs like project-structure.md, pyproject.md, ruff.md, mypy.md, pytest.md, etc.

Quick Start

Run the standard checks and build: uv run ruff check, uv run ruff format --check, uv run mypy, uv run pytest, and uv build.

Frequently Asked Questions about following-conventions

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

FAQPage Schema
How do I enforce Python coding standards across my project?

Enforce Python coding standards using ruff for linting and formatting, mypy for type checking, and pytest for testing. This Skill configures 4-space indentation, double quotes, 88-character line limits, import ordering, and naming conventions (snake_case for functions/modules, PascalCase for classes) enforced via uv-based tooling chains.

What tools do I need to set up Python linting and type checking?

You need uv for dependency management, Ruff for style checks and formatting, Mypy for static type analysis, and pytest for testing. This Skill integrates all four into a quality-gate workflow: uv run ruff check && uv run ruff format --check && uv run mypy && uv run pytest && uv build.

How do I configure pre-commit checks for Python projects?

Configure pre-commit style checks by chaining uv-based commands before commits or releases. This Skill enforces ruff check, ruff format validation, mypy type checking, and pytest test execution as mandatory gates, plus Python 3.12+ typing and naming conventions.

Can I use Ruff and Mypy together for Python code quality?

Yes, Ruff and Mypy work together in this Skill's workflow. Ruff handles linting and formatting (style, imports, line length), while Mypy enforces static type checking without Any types, creating comprehensive quality coverage across style and correctness.

What Python naming conventions does this Skill enforce?

This Skill enforces snake_case for modules, functions, and variables; PascalCase for classes; and CONSTANT_CASE for constants. It also requires Click-based CLI patterns with kebab-case flag names, integrated with mypy type checking and ruff formatting.