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

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 whimzyLive/nightshift-ai

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 with verified one-level-deep references and strong troubleshooting coverage. Its main weakness is redundancy — repeated sections and commands plus long inline JSON example outputs inflate the token cost without adding guidance value.

Suggestions

Merge the duplicate 'Listing Projects' sections (lines 12-44 and 149-172) and the repeated 'jq .targets | keys' command (lines 61, 73, 211, 273) into single canonical presentations to cut roughly a quarter of the body.

Move the large example JSON outputs ('Programmatic Answers': nx show project and nx graph samples) into a reference file, keeping only 2-3 line excerpts inline, so SKILL.md stays an overview.

Fix the copy-paste error at line 97: 'read the full project schema at node_modules/nx/schemas/nx-schema.json to understand nx project configuration options' should say workspace configuration options (it duplicates the project-schema sentence at line 52).

DimensionReasoningScore

Conciseness

The body avoids concept over-explanation (it never explains what Nx is) and is mostly command examples, but it has notable duplication: a second 'Listing Projects' section (lines 149-172) repeats the first, 'jq .targets | keys' appears four times (lines 61, 73, 211, 273), and ~80 lines of inline example JSON outputs pad the length. This matches anchor 3 ('mostly efficient but could be tightened') rather than 4 given the volume of repeated material, and not 2 since there is no padded conceptual prose.

3 / 5

Actionability

Fully executable, copy-paste-ready bash commands with jq recipes for every section, concrete example outputs, and an error-message-to-remedy troubleshooting section ('Cannot find configuration for task X:target' -> exact diagnostic commands). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

A read-only, query-driven reference skill (no destructive or batch operations, so the validation cap does not apply) organized by question/scenario with a troubleshooting section mapping failures to fixes. The duplicated 'Listing Projects'/'Project Details' sections blur navigation slightly and there is no ordering guidance, placing it at anchor 4 rather than 5's fully sequenced, checkpoint-rich structure.

4 / 5

Progressive Disclosure

The single bundle reference (references/AFFECTED.md) exists, is one level deep, and is clearly signaled from the body ('read the affected projects reference'). Structure is good, but the ~280-line body inlines large example-output blocks ('Programmatic Answers', ~80 lines of JSON samples) that are reference material and could be split out, matching anchor 4 rather than 5's appropriately split content.

4 / 5

Total

16

/

20

Passed

Description

87%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 an explicit, multi-condition 'USE WHEN' clause and literal user-phrased example triggers, including failure-driven ones. Its only weaknesses are the abstract 'Explore and understand' framing of the capabilities themselves and a few missing natural terms like 'monorepo' and 'affected'.

DimensionReasoningScore

Specificity

The core 'what' is generic ('Explore and understand Nx workspaces'), but the EXAMPLES clause explicitly enumerates several concrete capabilities: listing projects ('What projects are in this workspace?'), inspecting configuration ('How is project X configured?'), finding dependents ('What depends on library Y?'), target discovery, and failure debugging. This matches anchor 4 ('lists several specific actions; minor gaps') rather than 3, since coverage goes beyond 1-2 actions, and not 5, since the capability statements themselves are abstract verbs rather than concrete action lists.

4 / 5

Completeness

Both parts are explicit: what ('Explore and understand Nx workspaces... workspace structure, project configuration, available targets, and dependencies' implied via examples) and when ('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'). The 'when' is multi-condition, explicit, and backed by concrete trigger phrases — a clear anchor 5 match, above anchor 4 where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

Direct quotes of natural user phrasings ('What targets can I run?', 'Cannot find configuration for task', 'debug nx task failure') plus failure-triggered usage give strong, natural coverage. A few commonly said terms are missing ('monorepo', 'affected', 'dependencies', 'nx.json'/'project.json'), matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than 5's comprehensive synonym/extension-level coverage.

4 / 5

Distinctiveness Conflict Risk

A clear Nx-specific niche with tool-locked triggers ('nx command fails', 'Cannot find configuration for task') that no other skill would claim; minimal conflict risk, matching anchor 5 ('clear niche with distinct triggers').

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

whimzyLive/nightshift-ai

Path

.opencode/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.