Agent skill · software engineering · nexu-io
code-import
Read an existing repository's structure into the project cwd as a normalised snapshot the agent can analyse without re-walking the tree on every turn.
Why this skill is useful
Adds a script that normalizes repository structure into a snapshot, enabling efficient analysis without repeated tree walks.
What it needs
Requires od installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 84,236 stars on the source repository.
What this skill does
Code import Spec §10 / §21.3.2: a code-migration / tune-collab run starts from a real repo (cloned via od project import or a path the user provided). This atom turns the raw checkout into a normalised on-disk record that subsequent atoms (design-extract, rewrite-plan, patch-edit) operate against. The point is to stop re-walking the tree on every turn — the agent reads code/index.json once and trusts the snapshot until the next explicit re-import. Inputs Source Required Notes --- --- --- repoPath yes Absolute path to the repo's root, supplied via od project import or an upstream od.context.assets[] reference targetStack yes { framework, packageManager, styleSystem, componentLibrary } via the matching form GenUI surface Output code/index.json is the input every other Phase 7 atom reads. The walk respects the runner's budgetMs option (default 60s) so large monorepos don't burn an entire run on import. Convergence The atom completes when code/index.json exists and contains at least one entry. Empty repos abort with a clear error event so the user re-imports. Anti-patterns the prompt fragment forbids Walking nodemodules / .git / .next / dist / build (record in code/index.json.skipped[] with reason). Inferring a framework from a single file; require at least package.json's declared dep + a build-config presence (next.config., vite.config., etc.). Treating commented-out imports as live edges. Status Implemented by the daemon runner in apps/daemon/src/plugins/atoms/code-import.ts. The walker enforces its exclusions and time budget, detects framework evidence, and writes code/index.json.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nexu-io/code-import