Agent skill

refactor-import-hygiene

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

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/import-hygiene

Metadata

Additional technical details for this skill

author
Jordan Godau
keywords
import imports namespace shadowing collision from import symbol
references
[
    "01_GOAL.md",
    "02_DEFINITION.md",
    "03_RULES.md",
    "04_PROCEDURE.md",
    "05_OUTPUT.md",
    "06_EXAMPLES.md"
]

SKILL.md

Instructions

Read all references in references/ before using this skill.

Signals

  • Module-stutter was removed and symbols became intentionally generic (Metadata, Spec, File, Header, Payload)
  • A refactor moved code into new namespaces and callsites were updated
  • The diff introduces many from X import Y imports
  • There are repeated name collisions or ambiguous identifiers in local scopes

References

Directory: references/

  • 01_GOAL.md
  • 02_DEFINITION.md
  • 03_RULES.md
  • 04_PROCEDURE.md
  • 05_OUTPUT.md
  • 06_EXAMPLES.md

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results