What problem does it solve?
This Skill helps developers and engineering teams import existing repositories into an Nx workspace while preserving commit history and minimizing post-merge friction. It addresses the common pain points of moving projects across repository boundaries including directory conflicts, missing root configuration, and mismatched tooling versions.
Core Features & Use Cases
- Preserve Git History: Import files and full commit history so authorship and changes are retained.
- Two Import Strategies: Subdirectory-at-a-time for monorepo sources and whole-repo import for single-project repos, with guidance on when to use each.
- Post-import Remediations: Practical fixes for pnpm workspace globs, root dependency and nx.json merges, TypeScript project references, executor path adjustments, and plugin detection (ESLint, Jest, Vite, Next, Gradle).
- Use Case: Consolidate several team repositories into a single Nx monorepo, importing each app or library into apps/ or libs/, resolving dependency and tsconfig mismatches, and registering necessary Nx plugins.
Quick Start
Use the nx-import skill to import a source repository into your workspace by specifying the source path and a destination (for example apps/my-app or libs/my-lib), preserve git history, then update pnpm workspace globs and root dependencies before running nx sync --yes.