skills.rest
Suniljit
SuniljitCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/Suniljit/personal-toolkit --skill python-polish
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
le-goff-benoitle-goff-benoit
2

migration_read_target_file

Read target Odoo source files with line references during migration.

Community
Intermediate
muhammadhamad1104muhammadhamad1104

ship

Automate repository shipping workflows with branch operations, tests, and pull requests.

Community
Advanced
TheBushidoCollectiveTheBushidoCollective
187

python-type-system

Enforce Python type safety with mypy, Protocols, TypedDict, and Generics.

Official
Intermediate
kurokeitakurokeita
1

find-bugs

Analyze code changes to identify bugs, security vulnerabilities, and quality issues.

Community
Intermediate