CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nx-workspace-patterns

Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.

59

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/developer-essentials/skills/nx-workspace-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%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, token-efficient overview with exemplary progressive disclosure to a real, flat reference bundle. Its weaknesses are in-body actionability and workflow: no executable configuration appears in SKILL.md itself, and multi-step use cases like workspace setup and migration are covered as patterns rather than sequenced procedures with validation checkpoints.

Suggestions

Inline one minimal copy-paste-ready snippet in SKILL.md (e.g., the nx.json module-boundaries lint rule with tag enforcement) so the most common action is executable without opening references.

For the setup and migration use cases, add a short ordered procedure (create workspace -> generate libs -> configure boundaries -> enable caching -> verify with `nx graph` or `nx affected`) with explicit verification checkpoints.

Trim or move the library-type taxonomy table and generic do's/don'ts into references/details.md if they duplicate conventions Claude already knows.

DimensionReasoningScore

Conciseness

The 69-line body is lean and assumes competence — no 'what is a monorepo' padding, and the bulk of templates are correctly deferred to references. Minor trimming is possible: the library-type taxonomy table and generic do's/don'ts ('Keep libs focused - Single responsibility') restate conventions Claude already knows. Not 5 because those tokens could be cut without loss.

4 / 5

Actionability

The directory-layout tree and library-naming taxonomy are concrete reference material, but the body itself contains no executable commands or configuration — 'Use tags consistently - Enforce with module boundaries' names the goal without the how, and all runnable nx.json snippets live only in references/details.md. Not 4 because the executable guidance is entirely deferred rather than present with minor gaps; not 2 because the structural guidance is specific, not merely high-level hints.

3 / 5

Workflow Clarity

The advertised use cases ('Setting up new Nx workspaces', 'Migrating to Nx') are inherently multi-step processes, yet the body provides no sequenced procedure or checkpoints for any of them — it is a pattern catalog, not a workflow. Rough guidance exists (concepts, do's/don'ts) but step ordering is entirely absent. No destructive/batch operation applies, so no validation cap.

2 / 5

Progressive Disclosure

One clearly-signaled, one-level-deep reference: 'Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.' Verified against the actual bundle — the file exists (387 lines of nx.json/workflow templates), the path matches, and it contains no nested references, so navigation is flat and easy.

5 / 5

Total

14

/

20

Passed

Description

78%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 strong description in third person with an explicit 'Use when...' trigger clause and domain-specific trigger terms. Its main weakness is coverage: the trigger list omits several use cases (remote caching, dependency management, migration) that the skill body itself advertises.

DimensionReasoningScore

Specificity

The when-clause enumerates several concrete actions ('setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands'), though the what-clause ('Configure and optimize Nx monorepo workspaces') stays somewhat generic. It is not 5 because coverage is incomplete — the body itself lists dependency management and migration as use cases, which are absent from the description.

4 / 5

Completeness

Answers both what ('Configure and optimize Nx monorepo workspaces') and when (explicit 'Use when...' clause with concrete triggers). Not 5 because the when-clause covers only 4 of the 6 scenarios the body identifies (remote caching, dependency management, and migration are omitted), so it could be more comprehensive.

4 / 5

Trigger Term Quality

Includes natural phrases users would actually say in this domain: 'Nx', 'monorepo', 'project boundaries', 'build caching', 'affected commands'. Not 5 because common variations and file-level triggers are missing (e.g., 'nx.json', 'Nx workspace', 'migrate to Nx').

4 / 5

Distinctiveness Conflict Risk

'Nx' is a strong niche discriminator and the trigger set (Nx setup, boundaries, build caching, affected commands) is specific to this tool. Only negligible overlap risk with generic monorepo tooling skills.

5 / 5

Total

17

/

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

wshobson/agents

Path

plugins/developer-essentials/skills/nx-workspace-patterns/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.