python-polish

Run a three-stage Python code quality pipeline with stage-wise approvals.

Updated Feb 14, 2026

Search Tags:#python #refactor #review #code-quality #lint #polish #type-check

Ready to run

npx skills add https://github.com/Suniljit/personal-toolkit --skill python-polish

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: python-polish
Source: https://github.com/Suniljit/personal-toolkit/tree/main/.opencode/skills/polish-code
Command: npx skills add https://github.com/Suniljit/personal-toolkit --skill python-polish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates a three-stage Python code quality workflow that helps developers clean up code, catch issues early, and productionize changes with controlled approvals.

Core Features & Use Cases

Run a three-stage pipeline: review-code → simplify-code → py-lint-typecheck with stage-wise approvals between steps.
Supports targeted code cleanup, refactoring, and consistency enforcement across Python projects.
Use Case: You want to polish a legacy module by identifying bugs, reducing complexity, and applying lint/type-check fixes after your review.

Quick Start

Specify the target Python file or directory to polish, and I will run the 3-stage pipeline with approvals.

Frequently Asked Questions about python-polish

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

FAQPage Schema

How do I automate Python code review and lint type checking together?▼

Automate Python code review and lint type checking by running a three-stage pipeline that reviews, simplifies, and applies lint/type-check corrections with stage-wise approvals. This enforces end-to-end code cleanliness across individual scripts and small projects.

What is the best way to refactor and polish legacy Python modules safely?▼

The best way to refactor legacy Python modules is using a structured pipeline that identifies bugs, reduces complexity, and applies lint fixes. Code remains unchanged unless explicitly approved through stage-wise human approvals between each step.

Can I polish individual Python scripts without automatically applying unwanted changes?▼

Yes, you can polish individual Python scripts safely because the pipeline leaves code unchanged unless approved. It applies automatic lint and type-check corrections only after passing explicit stage gates and receiving human approval.

How does a stage-wise code quality pipeline work for Python projects?▼

A stage-wise Python code quality pipeline works by executing review-code, simplify-code, and py-lint-typecheck steps sequentially. It enforces controlled approvals at each stage gate before proceeding to the next phase of cleanup.

Does Python code polishing require any external dependencies to run?▼

No external dependencies are required to run this Python code polishing pipeline. The Skill operates independently to review, simplify, and lint code without needing additional environment setup or external component installations.