Why does this skill prioritize public methods over private ones?

Placing public methods first allows developers to understand a class's API immediately without scanning through implementation details, significantly improving code readability and maintenance.

Does this skill handle timezone issues automatically?

It provides patterns and enforcement rules to ensure all datetime objects are timezone-aware, specifically using UTC for internal operations to avoid the common pitfalls of 'naive' datetime objects.

What are the benefits of using section headers in Python services?

Section headers provide visual organization for complex services with many methods, allowing for faster navigation and logical grouping of related operations like CRUD vs. Query operations.

Can I use this for function-based modules as well as classes?

Yes, the skill includes specific organization principles for function-based modules, including the logical ordering of dataclasses, public API functions, and module utilities.

Python Style & Architecture

Name: Python Style & Architecture
Author: gestrich

bygestrich

0•

개발자 도구

Standardizes Python code organization, method ordering, and datetime handling for clean, maintainable codebases.

The Python Code Style skill provides comprehensive guidelines and automated patterns for structuring Python services and modules. It enforces a strict hierarchy for method organization—placing public API methods before private helpers—and mandates the use of timezone-aware datetimes to prevent common logic errors. By implementing these architectural patterns, developers can ensure consistency across complex projects, simplify onboarding for new contributors, and maintain high-quality type annotations and documentation standards.

주요 기능

01Standardized method hierarchy (Public, Private, Class, Static)

02Enforced timezone-aware datetime patterns

03ISO 8601 timestamp parsing utilities

04Section header templates for complex service modules

050 GitHub stars

06Best practices for module-level function organization

사용 사례

01Standardizing datetime logic to prevent timezone-related bugs

02Onboarding new developers to a project's coding standards

03Refactoring large service classes for better readability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gestrich/python-architecture python-code-style

For use in Claude.ai and ChatGPT

주요 기능

01Standardized method hierarchy (Public, Private, Class, Static)

02Enforced timezone-aware datetime patterns

03ISO 8601 timestamp parsing utilities

04Section header templates for complex service modules

050 GitHub stars

06Best practices for module-level function organization

사용 사례

01Standardizing datetime logic to prevent timezone-related bugs

02Onboarding new developers to a project's coding standards

03Refactoring large service classes for better readability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gestrich/python-architecture python-code-style

For use in Claude.ai and ChatGPT