CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

monorepo-navigator

Navigate, manage, and optimize monorepos. Covers Turborepo, Nx, pnpm workspaces, and Lerna. Cross-package impact analysis, selective builds/tests on affected packages, remote caching, dependency graph visualization, and structured multi-repo to monorepo migrations. Use when setting up a new monorepo, optimizing CI for a large workspace, debugging cross-package dependency issues, or planning a multi-repo consolidation.

67

Quality

84%

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

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

A well-structured overview skill with strong tables, concrete commands, and real one-level-deep references. Its main weakness is workflow clarity: multi-step, risky operations (migration, impact analysis) are described as capabilities but never sequenced with validation checkpoints in the body.

Suggestions

Add a numbered migration workflow with explicit validation checkpoints (e.g., verify history after `git filter-repo` with `git log`, run the test suite before and after consolidation, confirm all packages resolve via the analyzer's --json output) instead of relying on a one-line pitfall entry.

Sequence the impact-analysis workflow — detect tooling with scripts/monorepo_analyzer.py, run the tool's affected command, review the affected package list before merging — with a verification step rather than the vague 'run affected check, communicate blast radius'.

Expand the bare '## Turborepo' pointer into one or two key commands (e.g. `turbo run build --filter=...[origin/main]` with what it does) so the core selective-build workflow is executable from SKILL.md alone.

DimensionReasoningScore

Conciseness

Mostly efficient: dense tables (Tool Selection, Common Pitfalls) and terse best practices with no explanation of concepts Claude already knows. Not 5 because the Overview section duplicates the frontmatter description nearly verbatim and the Tier/Category/Domain metadata block adds no instructional value; these could be trimmed.

4 / 5

Actionability

Provides executable specifics: `python3 scripts/monorepo_analyzer.py /path/to/monorepo --json`, `--filter=...[origin/main]`, `git filter-repo --to-subdirectory-filter`, `pnpm changeset publish`, and `turbo run build --summarize`. Not 5 because the Turborepo section is only a bare pointer and the "step-by-step" migration capability has no steps or commands in the body, leaving key workflows dependent on reference files.

4 / 5

Workflow Clarity

No multi-step process in the body is sequenced with validation checkpoints. The migration — a claimed "step-by-step multi-repo → monorepo" operation involving history rewriting — appears only as a one-line pitfall fix, and impact analysis is reduced to "run affected check, communicate blast radius" with no sequence. Capped at 3 per the guideline on batch/destructive operations lacking validation loops; not 2 because the ordered Best Practices list and pitfalls-to-fixes mapping give a rough actionable sequence.

3 / 5

Progressive Disclosure

Good structure: the body stays lean as an overview, both referenced files exist (references/monorepo-tooling-reference.md, references/monorepo-patterns.md), references are one level deep, and the script path is given with usage. Not 5 because the "## Turborepo" section is just a bare arrow pointer with no summary of what the reference contains, and reference links are scattered mid-section rather than clearly signposted, leaving minor navigation gaps.

4 / 5

Total

15

/

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.

An excellent description: concrete capabilities, explicit 'Use when...' triggers covering four distinct scenarios, named tools, and a clear niche. Only minor room to improve trigger synonym coverage (file/config names, publishing/versioning terms).

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "Cross-package impact analysis, selective builds/tests on affected packages, remote caching, dependency graph visualization, and structured multi-repo to monorepo migrations" — plus named tools (Turborepo, Nx, pnpm workspaces, Lerna). Comprehensive coverage of the domain's action space; not 4 because there are no significant capability gaps.

5 / 5

Completeness

Explicitly answers both: what ("Navigate, manage, and optimize monorepos" followed by five concrete capability areas) and when ("Use when setting up a new monorepo, optimizing CI for a large workspace, debugging cross-package dependency issues, or planning a multi-repo consolidation"). Matches the 5 anchor exactly with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural keywords users would actually say: "monorepo", "setting up a new monorepo", "optimizing CI", "debugging cross-package dependency issues", "multi-repo consolidation", plus all four tool names. Not 5 because a few common synonyms and concrete artifacts users might mention (e.g. turbo.json, pnpm-workspace.yaml, "affected packages", "npm publish/versioning") are absent; clearly above 3 since coverage is broad, not partial.

4 / 5

Distinctiveness Conflict Risk

Clear niche (monorepo build tooling and architecture) with distinct triggers — specific tool names and monorepo-specific scenarios like "multi-repo to monorepo migrations" — making it unlikely to fire for unrelated skills. Third-person voice throughout, no over-claims.

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

alirezarezvani/claude-skills

Path

engineering/skills/monorepo-navigator/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.