python-workflow

Standardize Python project workflows with uv, Ruff, Mypy, and Pydantic.

Updated Apr 11, 2023
One-click install
npx skills add https://github.com/salverius-tech/dotfiles --skill python-workflow-salverius-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-workflow
Source: https://github.com/salverius-tech/dotfiles/tree/main/home/dot_claude/skills/python-workflow
Command: npx skills add https://github.com/salverius-tech/dotfiles --skill python-workflow-salverius-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidelines and best practices for developing Python projects, ensuring consistency, quality, and efficiency across various tools and architectural patterns.

Core Features & Use Cases

  • Tooling Standardization: Enforces consistent use of linters (Ruff), formatters, type checkers (Mypy, Pyright), and security scanners (Bandit).
  • Virtual Environment Management: Guides users on correct virtual environment usage with tools like uv to avoid cross-platform issues.
  • Code Quality & Style: Details PEP 8 compliance, naming conventions, documentation standards, and error handling.
  • Project Structure & Configuration: Offers recommended directory layouts and configuration management strategies.
  • Use Case: A new developer joins a Python project and needs to understand the established workflow for linting, testing, and managing dependencies. This Skill provides all the necessary information.

Quick Start

Follow the guidelines in this skill to set up a new Python project using uv for package management and ruff for linting and formatting.

Frequently Asked Questions about python-workflow

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

FAQPage Schema
How do I set up a Python project workflow using uv and Ruff?

To set up a Python project workflow with uv and Ruff, use uv for package management and virtual environment creation, then configure Ruff for combined linting and formatting to enforce PEP 8 compliance and code style standards.

What is the best way to manage Python virtual environments to avoid cross-platform issues?

The best way to manage Python virtual environments and avoid cross-platform issues is using uv. It provides strict, standardized environment isolation to ensure consistent dependency resolution and maintainable project configurations across different operating systems.

Does this Python workflow standardization support type checking with Mypy and Pydantic?

Yes, this Python workflow standardization supports type safety by enforcing the use of Mypy, Pyright, and Pydantic. These tools validate data structures and enforce strict typing to ensure high-quality, maintainable Python codebases.

How do you structure a Python project for CQRS and maintainable configuration?

Structuring a Python project for CQRS involves adopting recommended directory layouts that separate command and query responsibilities. It also requires implementing robust configuration management strategies and consistent error handling patterns.

Why include security scanners like Bandit in a Python development workflow?

Including security scanners like Bandit in a Python development workflow identifies potential vulnerabilities early. It enforces code quality by running automated security checks alongside linters and type checkers, ensuring high-quality, maintainable Python codebases.

What are the limitations of enforcing strict Mypy type checking in an existing Python codebase?

Enforcing strict Mypy type checking in an existing Python codebase may require extensive refactoring to add type annotations. While it improves type safety, it can initially slow down development when integrating legacy code into this standardized workflow.