What problem does it solve?
Moving or renaming files and modules often leads to a cascade of broken import statements, string paths, and configuration references across multiple languages (Python, TypeScript, JavaScript). This skill eliminates the tedious, error-prone manual work of updating these references, making refactoring seamless and reliable.
Core Features & Use Cases
- Multi-Language Support: Automatically updates imports and references in Python, TypeScript, and JavaScript files, ensuring consistency across your entire codebase.
- Comprehensive Reference Update: Handles not just import statements, but also string-based paths, configuration files, and even documentation examples, leaving no broken links behind.
- Systematic Verification: Before and after updates, it verifies that paths exist and imports resolve correctly, drastically reducing post-refactoring bugs and ensuring code integrity.
- Use Case: If you decide to move a
utils.py file to a new /common/utils/ directory, this skill will automatically find and update all from old_path import ... statements to from common.utils import ..., saving you hours of manual search-and-replace and preventing runtime errors.
Quick Start
Moving utilities to /utils:
1. Map old paths -> new paths
2. Find ALL references (imports, strings, configs, docs)
3. Update systematically by type
4. Verify paths exist and imports resolve
5. Report changes made (e.g., "23 files, 45 imports updated")