nx-import

Integrate external repositories into Nx workspaces while preserving Git history.

Updated May 31, 2026
One-click install
npx skills add https://github.com/julianaoddeus/BarberShop-angular --skill nx-import-julianaoddeus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nx-import
Source: https://github.com/julianaoddeus/BarberShop-angular/tree/main/my-barbershop/.opencode/skills/nx-import
Command: npx skills add https://github.com/julianaoddeus/BarberShop-angular --skill nx-import-julianaoddeus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The nx-import Skill streamlines the process of integrating external repositories into an Nx workspace, ensuring a seamless and organized development environment.

Core Features & Use Cases

  • Repository Integration: Merges external repositories into an Nx workspace.
  • Preserve Git History: Retains commit history during the import process.
  • Monorepo Strategy: Offers two strategies for monorepo sources (Subdirectory-at-a-time and Whole repo).
  • Use Case: If you have a set of independent projects that you want to consolidate into a single Nx workspace, this Skill will help you do so with ease.

Quick Start

Run the nx-import skill by executing nx import <source> <target> --source=<source_dir>.

Frequently Asked Questions about nx-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import an external repository into an Nx workspace while preserving Git history?

To import external repositories into an Nx workspace while preserving Git history, run the nx import command with your source and target directories. This integrates external projects and retains commit history during the consolidation process.

What is the best way to consolidate independent projects into a single Nx monorepo?

The best way to consolidate independent projects into a single Nx monorepo is using a repository integration Skill. It streamlines the merging process, offering monorepo strategies like whole repo or subdirectory-at-a-time to ensure an organized development environment.

Do I need the Nx CLI configured to merge external repositories into my workspace?

Yes, you need the Nx CLI configured and a target workspace setup to merge external repositories. The integration process requires the Nx CLI to execute the necessary scripts and properly map the imported projects into your environment.

What monorepo strategies are available for integrating external Git repositories?

Available monorepo strategies for integrating external Git repositories include whole repo and subdirectory-at-a-time approaches. These options allow you to control how external source directories are merged into the Nx workspace during the import process.

Why does importing external projects into Nx workspaces cause common integration issues?

Importing external projects into Nx workspaces causes common integration issues due to mismatched workspace configurations and Git history conflicts. Properly utilizing a dedicated import skill handles these common issues by streamlining the integration and preserving commit history.