CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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'.

64

Quality

81%

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, well-organized command reference for read-only Nx exploration, with excellent executable examples and a clearly signaled one-level reference for affected-project queries. Its main weakness is redundancy: the Programmatic Answers section and repeated jq snippets duplicate earlier content and inflate token cost without adding guidance.

Suggestions

Merge the 'Programmatic Answers' section into the earlier 'Listing Projects', 'Project Configuration', and 'Target Information' sections: fold the --json/jq variants and example outputs into those sections and delete the duplicated command blocks (e.g., '.targets | keys' currently appears four times).

Move the large fabricated example outputs (the full 'nx show project --json' and 'nx graph --print' JSON blocks) into a references/ file (e.g. references/EXAMPLES.md), keeping one short output snippet inline to show the shape.

Add a brief preflight note on disambiguating failure modes before running commands: how to tell 'nx not installed' from 'not in a workspace root' (e.g., check for nx.json in cwd), complementing the existing package-manager lockfile check.

DimensionReasoningScore

Conciseness

Most sections are lean command references with no concept padding, but the 'Programmatic Answers' section (~90 lines) re-covers Listing Projects and Project Details already shown above, and commands like 'nx show project my-app --json | jq ".targets | keys"' appear verbatim in four different sections. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' (anchor 3) rather than 2, since the padding is redundancy rather than explanation of concepts Claude already knows, and rather than 4 because the duplication is a whole section, not minor trimmings.

3 / 5

Actionability

Every section gives copy-paste-ready bash commands with concrete jq pipelines, realistic example outputs, and coverage of the common cases (list/filter projects, resolve config, inspect targets, query the graph, troubleshoot two frequent error messages). It matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases') and not 4, since there are no significant gaps in executable detail.

5 / 5

Workflow Clarity

The skill is a read-only exploration reference (no destructive or batch operations, so the validation cap does not apply), organized by question type with a Troubleshooting section that includes an explicit recovery loop ('nx sync' then 'nx reset # if sync doesn't fix stale cache') and a diagnostic pattern for 'Cannot find configuration for task' (check targets, then check which projects have the target). It sits at anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than 5 because there is no guidance for handling failure modes of the exploration commands themselves (e.g., nx not installed vs. wrong directory), and rather than 3 because the per-question patterns and error-recovery steps are explicit.

4 / 5

Progressive Disclosure

The bundle structure is sound: the affected-projects detail is correctly offloaded to a real, one-level-deep reference that is clearly signaled in the body ('read the [affected projects reference](references/AFFECTED.md)'), and the main file is organized under scannable headers. It is anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps') rather than 5 because sizable fabricated example outputs and the jq cookbook in 'Programmatic Answers' could live in a reference file, and that section's overlap with earlier sections slightly muddies navigation.

4 / 5

Total

16

/

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 with explicit use-when triggers and realistic example phrasings including failure scenarios. Its main gaps are the generic capability statement (exploring/understanding rather than listing the concrete operations) and a few missing natural terms like 'monorepo' or 'nx.json'.

DimensionReasoningScore

Specificity

The description names the domain ('Explore and understand Nx workspaces') and hints at a couple of semi-concrete capabilities ('check available targets/configuration', 'debug nx task failure'), but it never lists the specific actions the skill actually provides such as listing projects, resolving project configuration, or querying the project graph. This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several specific listed actions, and rather than 2, since the domain is named and the triggers reference concrete operations (targets, configuration, nx command failures).

3 / 5

Completeness

It explicitly answers 'what' ('Explore and understand Nx workspaces') and 'when' with two explicit trigger clauses ('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') plus concrete example phrases. This matches the anchor-5 pattern of a clear what AND when with concrete trigger phrases; it is not 4 because the 'when' is fully explicit rather than merely adequate.

5 / 5

Trigger Term Quality

Natural user phrases are well covered: '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', and 'debug nx task failure' are exactly what a user would type, including realistic error messages. It falls short of anchor 5 because common synonyms and file-based terms users would naturally mention (e.g. 'monorepo', 'nx.json', 'project.json', 'nx graph') are absent.

4 / 5

Distinctiveness Conflict Risk

The Nx anchor and nx-specific triggers ('nx command fails', 'Cannot find configuration for task') give it a clear niche with minimal conflict risk from unrelated skills. It stops short of 5 because clauses like 'answering questions about the workspace, projects, or tasks' and 'What targets can I run?' are tool-agnostic and could overlap with closely related monorepo/build-tool skills (Turborepo, Lerna, general task runners) that a user might invoke in the same breath.

4 / 5

Total

16

/

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

whimzyLive/nightshift-ai

Path

skills/nx-workspace/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.