clean-names

Rename Python identifiers to improve readability during refactors.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps ensure Python code readability by recommending and applying descriptive, unambiguous names for variables, functions, classes, and modules during refactors.

Core Features & Use Cases

  • Descriptive naming: Suggests names that clearly convey purpose aligned with domain language.
  • Scope-appropriate naming: Advises on names that match the code's scope, from small helpers to large modules.
  • Safe renaming guidance: Prefers safe, semantically consistent renames with minimal risk.

Quick Start

Review a Python code snippet and rename identifiers to improve clarity.

Frequently Asked Questions about clean-names

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

FAQPage Schema
How do I improve Python code readability by renaming variables and functions?

To improve Python code readability, you rename identifiers like variables and functions to be more descriptive. This ensures your code clearly conveys its purpose aligned with domain language during refactoring.

What is the best way to safely rename Python identifiers during a code review?

The best way to safely rename Python identifiers is to apply semantically consistent changes with minimal risk. This involves enforcing descriptive naming conventions while preserving scope and references across your project.

Can I use Python naming conventions to refactor large modules and classes?

Yes, you can refactor large modules and classes by applying scope-appropriate naming conventions. This advises on names that match the code's scope, ensuring clarity from small helper functions to large modules.

Does renaming Python variables preserve existing scope and module references?

Yes, renaming Python variables preserves existing scope and module references. The process provides safe renaming guidance to ensure semantically consistent changes without breaking dependencies across your project.

When do I need to refactor Python code for descriptive and unambiguous naming?

You need to refactor Python code for descriptive and unambiguous naming when existing identifiers fail to convey their purpose. This typically happens during code reviews or when aligning code with domain language.