How does Snake Polish ensure code quality?

It runs a multi-step verification process including iterative pytest runs, Ruff formatting/linting, and strict Mypy type checking before completion.

Which Python versions are targeted by this skill?

The skill prioritizes modern Python patterns available in version 3.10 and above, such as pipe syntax for Unions and advanced TypeGuards.

What is the primary purpose of the Snake Polish skill?

It is designed to handle the implementation phase of a Python project, taking a modernization plan and failing tests and turning them into clean, passing code.

Can I use Snake Polish without a plan?

While it works best with the 'stinkysnake' workflow, it can be used whenever you have clear interface definitions and failing tests ready for implementation.

Snake Polish: Python Implementation

Name: Snake Polish: Python Implementation
Author: Jamie-BitFlight

byJamie-BitFlight

•

Developer Tools

Implements modern Python functions and classes iteratively based on modernization plans and failing test suites.

Snake Polish is the core implementation engine for the 'stinkysnake' modernization workflow within Claude Code. It automates the transition from legacy code to high-quality modern Python by executing structured implementation plans, applying advanced type-hinting, and following test-driven development (TDD) principles. By iteratively running pytest and static analysis tools like Mypy and Ruff, it ensures that every new function not only passes its tests but also adheres to the highest standards of modern Python architecture, including Pydantic validation, Protocol-based design, and type-safe data structures.

Key Features

01Built-in support for modern libraries like Pydantic, HTTPX, and Orjson

0218 GitHub stars

03Automated application of modern Python patterns (TypeGuards, Protocols, Dataclasses)

04Structured implementation sequence from core logic to integration points

05Strict static analysis verification with Ruff and Mypy

06Iterative test-driven development loop using pytest and uv

Use Cases

01Refactoring legacy Python scripts into production-grade, type-safe modules

02Upgrading existing codebases to utilize modern Python 3.10+ syntax and standards

03Implementing complex business logic from predefined architectural blueprints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills snakepolish

For use in Claude.ai and ChatGPT

Download Skill