refactor-import-hygiene

star 6

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

JordanGunn By JordanGunn schedule Updated 1/9/2026
play_arrow Run Skill in Manus View GitHub

name: refactor-import-hygiene license: MIT description: | Audit Python imports to preserve semantic context and prevent shadowing after refactors. Prefer namespace-first imports over direct symbol imports for generic identifiers. metadata: author: Jordan Godau references: - 01_GOAL.md - 02_DEFINITION.md - 03_RULES.md - 04_PROCEDURE.md - 05_OUTPUT.md - 06_EXAMPLES.md keywords: - import - imports - namespace - shadowing - collision - from import - symbol

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
Install via CLI
npx skills add https://github.com/JordanGunn/skills --skill refactor-import-hygiene
Repository Details
star Stars 6
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator
JordanGunn
JordanGunn Explore all skills →