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'.
86
83%
Does it follow best practices?
Impact
90%
1.40xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger term coverage and completeness. The explicit 'USE WHEN' clauses with concrete examples make it very clear when this skill should be selected. The main weakness is that the core capability statement ('Explore and understand') could be more specific about the concrete actions performed.
Suggestions
Replace the vague 'Explore and understand' opener with specific actions like 'List projects, inspect configurations, show dependency graphs, and debug task failures in Nx workspaces'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Nx workspaces) and mentions actions like exploring projects, tasks, targets, configuration, and dependencies, but the core verb 'Explore and understand' is somewhat vague. It doesn't list concrete actions like 'list projects', 'show dependency graph', or 'inspect project configuration'. | 2 / 3 |
Completeness | Clearly answers both 'what' (explore and understand Nx workspaces, check available targets/configuration) and 'when' with explicit 'USE WHEN' clauses and concrete examples of user queries and error scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'workspace', 'projects', 'tasks', 'targets', 'configuration', 'depends on', 'nx command fails', 'debug nx task failure', 'Cannot find configuration for task'. These are terms users would naturally use when working with Nx. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche around Nx workspaces specifically. The trigger terms like 'Nx', 'workspace', 'targets', 'nx command fails' are domain-specific and unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill for Nx workspace exploration with concrete, executable commands throughout and good troubleshooting guidance. Its main weaknesses are content repetition across sections (the same jq commands for targets appear in 3+ places) and a somewhat monolithic structure that could benefit from splitting detailed examples into reference files. The important callout about not reading project.json directly is a valuable insight that demonstrates good domain knowledge.
Suggestions
Consolidate repeated target/project inspection commands that appear in 'Target Information', 'Common Exploration Patterns', and 'Programmatic Answers' into a single authoritative section to reduce redundancy.
Move the detailed example JSON outputs and programmatic operations into a separate reference file (e.g., references/PROGRAMMATIC.md) to keep the main skill leaner while preserving the valuable examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining basic concepts, but there's significant repetition—target information commands appear in multiple sections (Target Information, Common Exploration Patterns, Programmatic Answers/Project Details) with overlapping examples. The example JSON outputs, while useful, add bulk that could be trimmed. | 2 / 3 |
Actionability | Excellent actionability throughout—every section provides concrete, copy-paste-ready bash commands with real flags and jq filters. Example JSON outputs show exactly what to expect, and the commands cover a comprehensive range of use cases from simple listing to graph querying. | 3 / 3 |
Workflow Clarity | For a read-only exploration skill, the workflows are clear and well-sequenced. The 'Common Exploration Patterns' section maps user questions to specific command sequences. The troubleshooting section provides clear diagnostic steps. Since these are non-destructive read operations, validation checkpoints aren't critical, and the single important warning (don't read project.json directly) is clearly called out. | 3 / 3 |
Progressive Disclosure | There's a reference to 'references/AFFECTED.md' for affected projects, which is good progressive disclosure, but no bundle files were provided to verify it exists. The main content is quite long (~200 lines) with repetitive sections that could be split into reference files (e.g., the full example JSON outputs and programmatic patterns could be a separate reference). The structure within the file is well-organized with clear headers, but the content itself is somewhat monolithic. | 2 / 3 |
Total | 10 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
76a3678
Table of Contents
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.