CtrlK
BlogDocsLog inGet started
Tessl Logo

nx-workspace

Explore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to check available targets/configuration before running a task. EXAMPLES: 'What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?', 'What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure'.

68

Quality

85%

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

The canonical home for this skill is nx-workspace in nrwl/nx

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-structured reference whose commands are uniformly executable and whose troubleshooting section includes recovery loops. Its main cost is redundancy: repeated command examples and a duplicated schema-pointer sentence inflate the body without adding information.

Suggestions

Deduplicate the "nx show project <x> --json | jq '.targets | keys'" examples that appear in Target Information, Common Exploration Patterns, and Programmatic Answers — state the pattern once and reference it.

Fix the duplicated schema-pointer sentence in the Workspace Configuration section (line 97), which copies the Project Configuration sentence verbatim and mislabels node_modules/nx/schemas/nx-schema.json as the 'project schema'.

Move the long Programmatic Answers example outputs (project JSON, graph JSON) into a references file, keeping SKILL.md as a lean overview like the existing references/AFFECTED.md pattern.

DimensionReasoningScore

Conciseness

The body is mostly command-forward, but "nx show project <x> --json | jq '.targets | keys'" appears in three separate sections, the Programmatic Answers section re-covers Listing Projects and Project Details from earlier, and the schema-pointer sentence is duplicated near-verbatim at lines 52 and 97 (the second mislabels nx-schema.json as the 'project schema'). This is 'mostly efficient but could be tightened', not 2 — there is no padding that explains concepts Claude already knows.

3 / 5

Actionability

Every section gives copy-paste-ready bash and jq commands, with realistic example JSON outputs and per-question patterns ("How do I build/test/lint project X?" → exact commands). Guidance is fully executable and covers the common exploration cases.

5 / 5

Workflow Clarity

For a read-only exploration skill, each task maps to an unambiguous command sequence, and the Troubleshooting section provides explicit error-recovery loops ("nx reset # if sync doesn't fix stale cache"). No validation checkpoints are required for non-destructive read operations, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The body has clear section headers and one well-signaled, one-level-deep reference (references/AFFECTED.md, which exists and is linked from the Affected Projects section). Not 5 because sizable reference material — the Programmatic Answers JSON examples and full graph output — is inlined in SKILL.md where a second bundle file would keep the overview leaner.

4 / 5

Total

17

/

20

Passed

Description

82%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 with explicit dual use-when clauses and concrete example phrases that make triggering reliable. The main weakness is the generic what-clause, which undersells the skill's specific capabilities.

DimensionReasoningScore

Specificity

The what-clause "Explore and understand Nx workspaces" names the domain with generic actions, and only "check available targets/configuration" in the when-clause adds a concrete capability — matching 'names domain and 1-2 concrete actions, but not comprehensive'. Not 4 because the description never enumerates its several actual capabilities (listing projects, resolving config, inspecting targets, querying the dependency graph).

3 / 5

Completeness

It explicitly answers what ("Explore and understand Nx workspaces") and when, twice over — "USE WHEN answering questions about the workspace, projects, or tasks" and "ALSO USE WHEN an nx command fails" — with concrete example trigger phrases, exactly matching the anchor-5 example.

5 / 5

Trigger Term Quality

Six natural user phrasings ("What projects are in this workspace?", "debug nx task failure") plus "an nx command fails" give good keyword coverage matching the 'a few natural terms missing' anchor. Not 5 because common synonyms and artifacts users would mention ("monorepo", "nx.json", "project.json") are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Nx workspaces) with distinct triggers including failure-mode phrases like "Cannot find configuration for task", so it is unlikely to fire for unrelated skills. It does not trigger on generic 'workspace' queries alone since the examples are all Nx-specific.

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
nrwl/nx
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.