CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nx-import

Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, highly actionable body: nearly every line is a specific command, error signature, or config fix for real nx import failure modes, with excellent use of reference files for technology-specific depth. Its weaknesses are the absent end-to-end sequence with a final validation checkpoint for a batch/destructive operation, and version-sensitive guidance (nx 22.6.0, ESLint v9/v10) embedded in the main flow.

Suggestions

Add an ordered end-to-end procedure with a final validation step (e.g., after all imports: `pnpm install --no-frozen-lockfile`, then `nx run-many -t build test` to verify everything resolves and runs) so the batch import operation has a proactive checkpoint.

Consolidate version-sensitive guidance (the nx 22.6.0 interactive-behavior note, the ESLint v9 pinning, the typescript-eslint v7/v9 conflict) into a clearly labeled 'Version constraints' section so future readers can re-check it in one place.

Add one-line descriptions to `references/GRADLE.md` and `references/TURBOREPO.md` in the references list (like the other four entries) so readers know when to open them.

DimensionReasoningScore

Conciseness

The body is dense and imperative throughout ("Fix": "pnpm add -wD eslint@^9 @nx/eslint-plugin typescript-eslint", error-message strings, exact tsconfig keys), assuming Claude's competence with no concept padding — leaner than the 3 anchor. It falls short of 5 because time-sensitive version guidance ("After nx `22.6.0`, `nx import` responds with .ndjson outputs", "Pin ESLint to v9... ESLint 10 breaks") is woven into the main flow rather than isolated in a version/deprecation section, which the guidelines say should penalize conciseness.

4 / 5

Actionability

Fully executable guidance: exact install commands ("npx nx add @nx/jest", "pnpm install --no-frozen-lockfile"), a copy-paste JSON override snippet, precise error signatures ("MultipleProjectsWithSameNameError", "Cannot read properties of undefined (reading 'version')"), and concrete tsconfig settings ("moduleResolution": "bundler"). The `<source>` placeholders are appropriately parameterized, not pseudocode, so it holds the 5 anchor; the only vague line ("Read the nx docs if you have the tools for it") is trivial.

5 / 5

Workflow Clarity

The macro workflow (choose strategy → import → fix issues) is only implied by section order, and validation is reactive (per-error fixes like "If it reports nothing but typecheck still fails, `nx reset` first") rather than proactive checkpoints — matching the 3 anchor's "sequence present but checkpoints missing or implicit". Since the operation is batch/destructive (merge commits, `rm -rf imported/node_modules`, multi-repo imports) with no end-to-end verification step, the rubric's cap at 3 applies, ruling out 4.

3 / 5

Progressive Disclosure

Good structure: SKILL.md stays an overview/common-cases document and all six technology-specific topics live in real one-level-deep files under references/ (verified present, no nested cross-references), with most clearly signaled ("references/VITE.md — Vite projects (React, Vue, or both): ..."). Not 5 because GRADLE.md and TURBOREPO.md are listed bare with no description, so a reader cannot tell when to open them, and in-body pointers concentrate on JEST.md while others rely on the trailing list.

4 / 5

Total

16

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: third-person voice, an explicit what with the exact command named, and a USE WHEN clause with multiple natural trigger phrasings. Its only weakness is that the action verbs (import/merge/combine) restate one capability rather than enumerating distinct capabilities, leaving specificity just short of the top anchor.

DimensionReasoningScore

Specificity

"Import, merge, or combine repositories into an Nx workspace using nx import" names the domain and concrete actions with the specific tool, matching the "several specific actions; minor gaps" anchor. Not 5 because "import", "merge", and "combine" are near-synonyms for one capability rather than the multiple distinct actions in the 5-anchor example; not 3 because the tool and action verbs are concrete and cover the skill's scope.

4 / 5

Completeness

Both parts are explicit: what ("Import, merge, or combine repositories into an Nx workspace using nx import") and when ("USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository"), with concrete trigger phrases — a direct match to the 5 anchor. A 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository" supplies natural user phrasings plus synonyms for the core action (import/merge/combine/move/adopt), matching the comprehensive-synonym 5 anchor. "Migrate to monorepo" is absent but effectively covered by "move projects into a monorepo" and "adopt Nx", so it does not fall to the 4 anchor's "a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

A clear niche (Nx workspace imports) with distinct triggers tied to Nx/monorepo context, minimizing conflict with generic git or build skills — matches the 5 anchor. Not 4 because the "Nx workspace" qualifier keeps overlap with adjacent skills minimal rather than minor-but-present.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

whimzyLive/nightshift-ai

Path

skills/nx-import/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.