refactor-module-stutter

Community

Eliminate module-name stutter in Python APIs.

AuthorJordanGunn
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Public Python APIs often expose symbols that redundantly repeat the module name (e.g., a module named fragment exporting WriteFragment). This pattern adds noise and harms readability, maintainability, and import ergonomics.

Core Features & Use Cases

  • Detect module-name stutter in top-level classes and functions, including re-exports declared in init.py.
  • Generate a concise Markdown report with recommended renames and safe refactor paths, suitable for CI gating.
  • Configurable exclusions via ignore rules to adapt to large codebases and gradual migrations.

Quick Start

Install and run the checker against your Python package to surface stutter findings and suggested fixes.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: refactor-module-stutter
Download link: https://github.com/JordanGunn/skills/archive/main.zip#refactor-module-stutter

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.