boy-scout

Automate proportional cleanup during incremental Python edits.

2|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/proven-xyz/proven-app --skill boy-scout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boy-scout
Source: https://github.com/proven-xyz/proven-app/tree/main/.agents/skills/boy-scout
Command: npx skills add https://github.com/proven-xyz/proven-app --skill boy-scout

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When editing Python code, this Skill enables proportional cleanup focused on low-risk refactors, naming improvements, and dead-code removal to improve readability and maintainability without changing behavior.

Core Features & Use Cases

  • Proportional cleanup during edits to improve naming, comments, and code structure.
  • Safe, incremental improvements that avoid broad rewrites and preserve functionality.
  • Use Case: when touching an existing Python module for small changes, apply targeted cleanup to reduce technical debt.

Quick Start

Run a small, proportional refactor to improve naming, remove dead code, and add clear comments in the touched Python module.

Frequently Asked Questions about boy-scout

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

FAQPage Schema
What is proportional cleanup and when should I use it for Python refactoring?

Proportional cleanup applies low-risk refactors, naming improvements, and dead-code removal to Python modules during small edits. Use it when touching existing modules to reduce technical debt without changing behavior.

How do I remove dead code and improve naming in an existing Python module?

Run a targeted, incremental cleanup on the touched Python module to improve naming, remove dead code, and add clear comments. This non-invasive approach preserves functionality while aligning with project conventions.

Can I use proportional cleanup for large-scale Python rewrites?

No, proportional cleanup is designed for small-to-medium refactors and incremental edits. It avoids broad rewrites, ensuring changes are non-invasive and preserve existing behavior across touched Python modules.

What's the best way to do incremental Python refactoring without breaking functionality?

Apply proportional cleanup during edits to perform safe, incremental improvements. This method avoids broad rewrites and explicitly preserves functionality while updating comments and structure in existing Python modules.

Does Python proportional cleanup require any specific dependencies or environment setup?

No dependencies are required. The cleanup process operates directly on existing Python modules, applying naming improvements and dead-code removal while aligning with Python project conventions and best practices.