python-code-quality

Quick reference for Python code quality tools: ruff (linting & formatting), ty (type checking).

laurigates/claude-plugins|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Installation Guide

Select your AI agent

How to use python-code-quality on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add python-code-quality

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/laurigates/claude-plugins --skill python-code-quality

Fetches python-code-quality from laurigates/claude-plugins and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/python-code-quality

Restart Cursor to activate python-code-quality. Access via /python-code-quality in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

Quick Reference

Ruff (Linter & Formatter)

# Lint code uv run ruff check . # Auto-fix issues uv run ruff check --fix . # Format code uv run ruff format . # Check and format uv run ruff check --fix . && uv run ruff format . # Show specific rule uv run ruff check --select E501 # Line too long # Ignore specific rule uv run ruff check --ignore E501

ty (Type Checking)

# Type check project uv run ty check # Type check specific file uv run ty check src/module.py # Check with explicit Python version uv run ty check --python 3.11 # Verbose output uv run ty check --verbose

pyproject.toml Configuration

[tool.ruff] line-length = 88 target-version = "py311" [tool.ruff.lint] select = [ "E", # pycodestyle errors "W", # pycodestyle warnings "F", # pyflakes "I", # isort "N", # pep8-naming "UP", # pyupgrade "B", # flake8-bugbear ] ignore = [ "E501", # line too long (handled by formatter) ] [tool.ruff.lint.isort] known-first-party = ["myproject"] [tool.ty] python-version = "3.11" exclude = [ "**/__pycache__", "**/.venv", "tests", ] [tool.ty.rules] possibly-unbound = "warn"

Type Hints

# Modern type hints (Python 3.10+) def process_data( items: list[str], # Not List[str] config: dict[str, int], # Not Dict[str, int] optional: str | None = None, # Not Optional[str] ) -> tuple[bool, str]: # Not Tuple[bool, str] return True, "success" # Type aliases from typing import TypeAlias UserId: TypeAlias = int UserDict: TypeAlias = dict[str, str | int] def get_user(user_id: UserId) -> UserDict: return {"id": user_id, "name": "Alice"}

# .pre-commit-config.yaml repos: - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.1.9 hooks: - id: ruff args: [--fix] - id: ruff-format - repo: https://github.com/astral-sh/ty rev: v0.0.10 hooks: - id: ty

python-code-quality

Installation Guide

How to use python-code-quality on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

Python Code Quality

When This Skill Applies

Quick Reference

Ruff (Linter & Formatter)

ty (Type Checking)

pyproject.toml Configuration

Type Hints

Pre-commit Configuration

Common Ruff Rules

See Also

References

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

python-expert-best-practices-code-review

fastapi-python

python-expert

improve

clean-code-principles

code-simplifier

Reviews

Discussion