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.
SKILL.mdskills/refactor/import-hygiene/SKILL.md
GitHubInstructions
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 Yimports - There are repeated name collisions or ambiguous identifiers in local scopes
References
Directory: references/
01_GOAL.md02_DEFINITION.md03_RULES.md04_PROCEDURE.md05_OUTPUT.md06_EXAMPLES.md