CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

run-nx-generator

Run Nx generators with prioritization for workspace-plugin generators. Use this when generating code, scaffolding new features, or automating repetitive tasks in the monorepo.

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/run-nx-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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.

The body is well-sectioned and reasonably lean, with a genuinely useful concrete example, but it is not execution-ready: the first workflow step is empty, key commands are placeholders, guidance for the schema tool is duplicated, and pinned version numbers will go stale. It reads as a solid draft that needs one tightening pass.

Suggestions

Fill in step 1 with the actual command or tool call for listing available generators (e.g. the `mcp__nx-mcp__nx_generators` tool that is already in allowed-tools but never mentioned in the body).

Remove the duplicated `mcp__nx-mcp__nx_generator_schema` sentence (keep it only as step 2) and drop the trailing "When to Use This Skill" section, which restates the description.

Generalize the example's pinned versions (e.g. `--nxVersion <version>`) or move version-specific values to a clearly labeled section so they don't silently go stale, and add a failure branch to the verify step (what to do when tests or dry-run fail).

DimensionReasoningScore

Conciseness

Most sections are tight, but there is real waste: the instruction to use the `mcp__nx-mcp__nx_generator_schema` tool is repeated verbatim (under "Generator Priority List" and again as step 2), the trailing "When to Use This Skill" section restates the description's trigger content, and the example pins time-sensitive version numbers ("--nxVersion 22.1.0-beta.7", "--newVersion 0.0.10") outside any deprecated/old-patterns section. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than a 4, where only minor trimming would be needed.

3 / 5

Actionability

Mixed concreteness: step 1 "List available generators:" is literally empty — no command or tool invocation follows it — and step 3 gives the placeholder form `nx generate [generator-path] [options]` plus `npx oxfmt [files]`. The bump-maven-version example and `nx affected -t test` are fully executable, but the empty step and placeholders are key missing details, matching 'some concrete guidance but incomplete... missing key details' rather than a 4.

3 / 5

Workflow Clarity

The list → schema → run → verify sequence exists and validation is present (review files, `nx affected -t test`, oxfmt, plus the `--dry-run` practice), so the destructive/batch cap is not triggered. However step 1 is an incoherent gap (an empty instruction), the verify step doesn't say what to do on failure, and there is no feedback loop (validate → fix → retry), matching 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'. It is above a 2 because the core sequence and checks are recognizable and mostly concrete.

3 / 5

Progressive Disclosure

No bundle files exist, and the ~74-line body is appropriately kept in one file with clear section headers (priority list, how to run, best practices, examples) — no content obviously belongs in a separate reference. It misses a 5 because the 50-line simple-skill exception doesn't apply (the body exceeds it) and there are minor organization gaps: duplicate guidance in two places, a "When to Use This Skill" section that duplicates the frontmatter description, and an empty step where a concrete command belongs.

4 / 5

Total

13

/

20

Passed

Description

70%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 solid, appropriately concise description: it states a concrete what (running Nx generators with workspace-plugin prioritization) and an explicit when-clause with natural trigger keywords. The main weakness is that the when-triggers are broader than the skill's actual Nx-specific niche, slightly weakening completeness and distinctiveness.

Suggestions

Tighten the when-clause to the skill's niche, e.g. "Use this when scaffolding or generating code, projects, or migrations in the Nx monorepo" so generic code-generation requests don't match.

Add one or two more concrete actions to the what (e.g. "scaffold apps and libraries, run migrations and version bumps") to lift specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

"Run Nx generators with prioritization for workspace-plugin generators" names the domain and one concrete action (running generators with a prioritization policy), but lists no further specific operations (no scaffolding targets, no migration/formatting actions). This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; it is above a 2 because the prioritized-generator scope is a concrete mechanism, not generic filler, but below a 4 because there is no enumeration of several concrete actions.

3 / 5

Completeness

Both halves are present: the what ("Run Nx generators with prioritization for workspace-plugin generators") and an explicit when ("Use this when generating code, scaffolding new features, or automating repetitive tasks in the monorepo"). Not a 5 because the trigger phrases remain somewhat generic — "generating code" or "automating repetitive tasks" could match many non-Nx requests — so the when is less concretely tied to this skill's niche than the anchor 5 example.

4 / 5

Trigger Term Quality

"generating code, scaffolding new features, or automating repetitive tasks in the monorepo" provides good natural keyword coverage — users would plausibly say "scaffold a new feature" or "generate code in the monorepo". It falls short of a 5 because common variations and synonyms are missing (e.g., "create a new app/library", "Nx workspace", "run a generator").

4 / 5

Distinctiveness Conflict Risk

The "Nx generators" and "workspace-plugin generators" terminology carves out a clear, tool-specific niche that few other skills would claim, and the "monorepo" qualifier narrows scope further. Minor overlap risk remains: the broad when-clauses ("generating code", "automating repetitive tasks") could fire on general code-generation requests where Nx is not intended, keeping it below a 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

nrwl/nx

Path

.claude/skills/run-nx-generator/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.