Skills
.Work. You
Rest

refactor-import-hygiene

Community

Preserve semantic context in Python imports.

Software Engineering#python#refactor#hygiene#namespace#import#shadowing
AuthorJordanGunn
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Audit Python imports to preserve semantic context and prevent shadowing after refactors. Prefer namespace-first imports over direct symbol imports for generic identifiers.

Core Features & Use Cases

  • Namespace-first imports: Keep imports qualified to preserve module context and readability.
  • Shadowing prevention: Minimize collisions with generic identifiers like Metadata, Config, and Payload.
  • Guided refactor assistance: Detect and propose changes from from X import Y to module-qualified usage or aliasing.

Quick Start

Run the hygiene checker to rewrite 'from X import Y' patterns to 'import X as alias' or to module-qualified usage and update callsites accordingly.

Dependency Matrix

Required Modules

None required

Components

references

💻 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-import-hygiene
Download link: https://github.com/JordanGunn/skills/archive/main.zip#refactor-import-hygiene

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.