What is the Boy Scout Rule in software development?

The Boy Scout Rule is the practice of always leaving the code cleaner than you found it by making small, incremental improvements every time you touch a file.

Will this skill perform massive refactors automatically?

No, the skill is specifically designed to avoid massive unrelated refactors. It focuses on 'blast radius' improvements near the code you are already changing.

Does this skill work with any programming language?

Yes, while it contains specific patterns for languages like TypeScript and Elixir, the principles of cleaning dead code, improving naming, and fixing logic apply to all languages.

How does this skill handle verification?

The Boy Scout Rule process includes a verification step where Claude is instructed to run the project's test suite and linter after making improvements to ensure no regressions were introduced.

Boy Scout Rule

Name: Boy Scout Rule
Author: TheBushidoCollective

byTheBushidoCollective

•

Developer Tools

Improves code quality and maintainability incrementally by cleaning up technical debt during feature development or bug fixes.

The Boy Scout Rule skill empowers Claude to act as a responsible steward of your codebase by applying the principle of leaving code better than it was found. It guides Claude to identify and execute small, high-impact improvements—such as fixing linting errors, improving variable naming, and removing dead code—while performing routine modifications. By integrating these micro-refactors into the standard development workflow, this skill prevents the accumulation of technical debt and ensures long-term project health without requiring dedicated refactoring cycles.

Key Features

01Incremental linting and formatting fixes in modified files

02Modernization of legacy syntax and logic simplification

03Automated identification and removal of dead or commented-out code

04Descriptive renaming of vague variables and functions

05Standardized commit message documentation for cleanup activities

0639 GitHub stars

Use Cases

01Modernizing legacy files while implementing new features

02Ensuring consistent type safety and documentation in active modules

03Cleaning up technical debt during routine bug fixes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han boy-scout-rule

For use in Claude.ai and ChatGPT

Download Skill