nx-multi-repo-migrate

Migrate several repos to a target nx version (e.g. 23.0.0-beta.25) in one coordinated pass — delegates `nx migrate` + migrations to a Polygraph child agent per repo, then pushes branches and opens linked draft PRs. Use when asked to upgrade/migrate multiple repos to a specific nx version, or when working a Polygraph session whose goal is an nx version bump across repos.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Medium

Suggest reviewing before use

Quality

Content

88%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.

An expert-level, highly actionable migration runbook with strong sequencing and thorough validation for a batch operation. It is dense and long but justified by non-obvious detail; the main opportunity is splitting the largest sections and Gotchas into reference files for better progressive disclosure.

Suggestions

Move the 'Gotchas from real runs' section into a references/GOTCHAS.md file and surface a one-line pointer from the main procedure, reducing upfront token load while keeping the detail one level deep.

Break the very long step 7 (orchestrated loop) and step 8 (classic fallback) into a references/MIGRATION-MODES.md so the core Procedure stays a lean overview.

Trim conversational asides (the pharmacist analogy, '(never mention AI/Claude)') to tighten conciseness without losing operational substance.

Dimension	Reasoning	Score
Conciseness	Dense with genuinely non-obvious operational detail (env-var bypass values, version thresholds, sandbox pitfalls) that assumes Claude's competence and earns its tokens; minor trimmable asides remain (the pharmacist analogy, parentheticals like '(never mention AI/Claude)').	4 / 5
Actionability	Provides copy-paste-ready commands throughout — 'git fetch origin <base> && git checkout -B migrate-nx-<VERSION> origin/<base>', 'NX_MIGRATE_ORCHESTRATOR=true <pm> nx migrate --run-migrations --create-commits --commit-prefix=...', and a per-package-manager cheat sheet — covering the common cases concretely.	5 / 5
Workflow Clarity	An 11-step procedure with explicit validation (step 9 'Verify before declaring done', a per-repo verification checklist) and feedback loops for error recovery (crash/timeout resume, retry-clean/skip step-actions, behind-count base-drift detection) — fully satisfying the batch-operation validation requirement.	5 / 5
Progressive Disclosure	Well-organized into clear sections (Input, Procedure, Verification checklist, Gotchas) with no nested references, but the skill is monolithic — all content is inline in SKILL.md with no bundle files, and very long steps (7, 8) plus the Gotchas block could conceivably be offloaded to references.	4 / 5
	Total	18 / 20 Passed

Description

92%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.

A highly specific, well-triggered description that clearly states both capability and invocation conditions for a narrow, well-defined niche. The only minor gap is keyword variation coverage within its specialized domain.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Migrate several repos to a target nx version', 'delegates nx migrate + migrations to a Polygraph child agent per repo', 'pushes branches and opens linked draft PRs' — with comprehensive coverage of the skill's behavior.	5 / 5
Completeness	Explicitly answers both what (migrate repos via per-repo child agents, push branches, open linked draft PRs) and when ('Use when asked to upgrade/migrate multiple repos... or when working a Polygraph session whose goal is an nx version bump'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural trigger phrases are present ('asked to upgrade/migrate multiple repos to a specific nx version', 'nx version bump across repos', 'Polygraph session'), but the narrow domain leaves a few plausible variations (e.g. 'bump nx', 'update nx across repos') uncovered.	4 / 5
Distinctiveness Conflict Risk	The combination of nx version targeting, multi-repo scope, and Polygraph child-agent delegation carves a clear niche with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning

	Total	15 / 16 Passed

Repository: nrwl/nx
Path: .claude/skills/nx-multi-repo-migrate/SKILL.md
Commit: 9064aa9

Reviewed: about 5 hours ago

Table of Contents

Discovery Implementation Validation

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.