circular-import-safety

What problem does it solve?

This Skill helps developers detect, diagnose, and safely resolve circular Python import cycles, preventing ImportErrors and ensuring code stability.

Core Features & Use Cases

• Cycle Detection: Identifies known circular import paths within the codebase.
• Decision Guidance: Provides a decision tree to determine if lazy imports are necessary or if structural refactoring is a better solution.
• Pattern Enforcement: Details approved lazy wrapper patterns and explicitly forbids problematic import strategies.
• Validation Tools: Includes commands to quickly test for import errors and enforce linting rules.
• Use Case: When encountering an ImportError during application startup or when about to introduce a new import that might create a cycle, use this skill to understand the problem and apply the correct fix.

Quick Start

Run the combined pre-edit safety check to ensure no circular imports exist before making changes.