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

86%

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

75%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, executable reference for Nx workspace exploration with good scenario organization and a well-integrated bundle reference. Its main costs are redundancy — repeated jq recipes and a Programmatic Answers section that duplicates earlier content — and inline example outputs that inflate token usage.

Suggestions

Consolidate the repeated 'jq .targets | keys' / '.targets.build' recipes that appear across Project Configuration, Target Information, Common Exploration Patterns, and Programmatic Answers into a single section.

Trim or move the large example JSON outputs (project config and graph) into a reference file, keeping only the jq extraction patterns inline in SKILL.md.

Merge the Programmatic Answers subsections (Listing Projects, Project Details) into their earlier counterparts, keeping only the 'prefer --json and process with jq' principle as guidance.

DimensionReasoningScore

Conciseness

The body is mostly efficient command recipes, but has notable duplication: 'jq .targets | keys' recipes appear in the Project Configuration, Target Information, Common Exploration Patterns, and Programmatic Answers sections, and the Programmatic Answers section re-covers Listing Projects and Project Details already shown above. This fits the 'mostly efficient but could be tightened' anchor rather than the 'minor instances' anchor 4.

3 / 5

Actionability

Every section gives copy-paste-ready, executable commands with realistic flag combinations (e.g. "nx show projects -p 'tag:publishable,!tag:internal'", "nx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "shared-ui") | .key'") covering the common exploration cases, matching the fully-executable top anchor.

5 / 5

Workflow Clarity

Content is organized by user question ('What's in this workspace?', 'How do I build/test/lint project X?') with a troubleshooting section containing an error-recovery fallback ('nx reset # if sync doesn't fix stale cache'). It falls short of anchor 5 because there is no explicit sequencing or validation checkpoints for the exploration process itself — it is a lookup reference rather than a guided workflow.

4 / 5

Progressive Disclosure

Good structure with a clearly signaled, real one-level reference ('read the [affected projects reference](references/AFFECTED.md)', which exists in the bundle), but roughly a third of the body (the Programmatic Answers example JSON outputs and repeated jq recipes) is inline detail that could live in reference files. Matches the 'good structure, minor organization gaps' anchor rather than anchor 5's clean overview-plus-references split.

4 / 5

Total

16

/

20

Passed

Description

90%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 excellent, natural trigger coverage and explicit use-when guidance including failure scenarios. Its only weakness is that the 'what' is generic ('Explore and understand') rather than enumerating the concrete exploration capabilities implied by its examples.

DimensionReasoningScore

Specificity

The description names the domain ('Nx workspaces') but the stated actions are generic ('Explore and understand'); concrete capabilities like listing projects, inspecting targets, or querying dependencies only surface indirectly through the example questions. This sits between anchor 2 (domain named, minimal actions) and anchor 4 (explicit list of specific actions), so the intermediate score applies.

3 / 5

Completeness

Both 'what' ('Explore and understand Nx workspaces') and 'when' ('USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails...') are explicitly stated with concrete example trigger phrases, matching the top anchor. Not 4 because the 'when' clause is far more explicit than that anchor's example.

5 / 5

Trigger Term Quality

Natural trigger phrases are comprehensive: user question forms ('What projects are in this workspace?', 'How is project X configured?', 'What depends on library Y?') plus real failure messages ('Cannot find configuration for task', 'debug nx task failure'). This matches the comprehensive-synonyms anchor exactly.

5 / 5

Distinctiveness Conflict Risk

Nx is a specific tool with a clear niche ('Nx workspaces', 'nx command fails', 'nx task failure'), so triggers are distinct and unlikely to fire for other skills. Matches the clear-niche anchor; no neighboring anchor fits better.

5 / 5

Total

18

/

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.