Content
85%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 catalog for read-only Nx workspace exploration with no fragile multi-step operations. Its one weakness is repetition across sections that inflates the token budget without adding capability.
Suggestions
Consolidate the `--affected` examples into the single 'Affected Projects' section and reference it elsewhere instead of re-listing the same `--base`/`--type`/`--exclude` variants in 'Listing Projects' and 'Common Exploration Patterns'.
Merge the overlapping target-listing commands (`jq '.targets | keys'`, `--withTarget serve/e2e`) that currently appear in both 'Project Configuration' and 'Target Information' into one location.
Tighten the 'Targets define what tasks can be run on a project.' line — Nx 'targets' are domain-specific, but the definition is not needed given the immediately following executable examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense and avoids explaining concepts Claude already knows, but it is not lean — the `--affected` examples recur across three sections, `--withTarget serve/e2e` across two, and `nx show project ... | jq '.targets | keys'` appears in both Project Configuration and Target Information, so not every token earns its place. | 2 / 3 |
Actionability | Guidance is fully executable and copy-paste ready throughout — concrete `nx show projects`/`nx show project ... --json | jq ...` commands plus fallbacks like `grep -r` and `git diff --name-only`, matching the 'fully executable code/commands' anchor. | 3 / 3 |
Workflow Clarity | This is a read-only exploration skill with no destructive or batch operations requiring validation checkpoints, and the Common Exploration Patterns section maps each user question to specific commands; per the simple-skill scoring note, unambiguous single-action workflows may score 3. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the body is a well-organized single-file catalog with clearly headed sections and no nested references; the only file references point to external node_modules schemas, so the self-contained structure is appropriate. | 3 / 3 |
Total | 11 / 12 Passed |