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.
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 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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?