endorsment/.github/skills/alias-guardian/SKILL.md

name, description, license, triggers

name	description	license	triggers
alias-guardian	Refactors relative imports into tsconfig/Vite aliases (e.g., `@/components`) to keep imports consistent and resilient to file moves.	MIT	refactor imports to @/ apply tsconfig aliases clean relative imports

Alias Guardian

When to use this skill

• Run after adding tsconfig path aliases or when many long relative imports exist.
• Triggered by prompts to convert ../../.. style imports to @/ aliases.

Instructions

1. First Step: Ensure tsconfig.json has paths configured ("@/*": ["src/*"]) and vite.config.ts supports the aliases (via vite-tsconfig-paths or manual resolve.alias).

2. Second Step: Use an AST-based tool (e.g., jscodeshift, ts-morph) or a controlled regex to find and replace relative import paths. Prefer AST to avoid accidental matches.

3. Third Step: Update affected files' imports to the alias form and run TypeScript to verify no resolution errors.

Examples

• Before: import PaperCard from '../../components/molecules/PaperCard'
• After: import PaperCard from '@/components/molecules/PaperCard'

Additional Resources

• ts-morph: https://github.com/dsherret/ts-morph
• jscodeshift: https://github.com/facebook/jscodeshift

Notes

• Always run tests and TypeScript type-check after mass refactors; commit in a dedicated branch and use Git to move files safely.