python-best-practices

Provides Python patterns for type-first development with dataclasses, discriminated unions, NewType, and Protocol. Must use when reading or writing Python files.

1.66x

Quality

67%

Does it follow best practices?

Impact

88%

1.66x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/skills-md/0xbigboss/claude-code/python-best-practices/SKILL.md

Evaluation results

82%

35%

E-Commerce Order Lifecycle Model

Type-safe domain model with discriminated unions and NewType

Criteria

Without context

With context

Frozen dataclasses

20%

100%

Discriminated union state

41%

100%

Union type alias

100%

NewType for IDs

100%

match/case exhaustive handling

100%

Descriptive exceptions raised

100%

Exception chaining

Type annotations on all signatures

75%

100%

Comprehensions over loops

No mutable class-level state

100%

Types defined before implementation

100%

31%

Service Configuration Loader

Config management with dataclass as single source of truth

Criteria

Without context

With context

Config frozen dataclass

41%

100%

from_env classmethod

20%

100%

No scattered os.getenv

66%

100%

Required value validation

100%

Sensible defaults for optional settings

50%

100%

Config used as single source of truth

100%

Type annotations on config fields

100%

Descriptive startup failure

100%

Config instantiated at module level

100%

No mutable config state

20%

100%

83%

40%

Document Conversion Pipeline

Protocol structural typing and functional patterns

Criteria

Without context

With context

Protocol definition

100%

Protocol used in signatures

100%

pathlib for file paths

100%

Context manager for I/O

100%

37%

Explicit encoding

100%

functools.partial usage

100%

Pure functions preferred

100%

__init__.py public API

100%

Private module naming

100%

Descriptive exceptions

22%

66%

Comprehensions over loops

77%

Repository: NeverSight/skills_feed
Commit: f772de4

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

E-Commerce Order Lifecycle Model Service Configuration Loader Document Conversion Pipeline

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.