CtrlK
BlogDocsLog inGet started
Tessl Logo

nx-generate

Generate code using nx generators. INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure. Trigger words - scaffold, setup, create a ... app, create a ... lib, project structure, generate, add a new project. ALWAYS use this BEFORE calling nx_docs or exploring - this skill handles discovery internally.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.cursor/skills/nx-generate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-engineered, execution-focused skill: every step carries a runnable command, dry-run and verification checkpoints are mandatory, and failure paths (wrong generator, failing verification, unsupported dry-run) have explicit recovery guidance. The only real improvements are trimming the generic intro and moving the library-buildability reference detail out of the main file.

Suggestions

Delete or compress the opening paragraph about what Nx generators are — Claude already knows this — and drop the 'This skill applies when' list that duplicates the frontmatter description.

Move the buildable vs non-buildable table and prose (plus the `--directory` gotcha) into a references/ file (e.g. references/library-options.md) and keep a one-line decision summary inline.

Make step 7's run command concrete by reusing the example from step 6 (e.g. `npx nx g @nx/react:library --name=my-lib --no-interactive`) so every step is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense and instructional — commands, a decision table, and a gotcha callout with almost no filler. Minor trimmable padding remains: the opening paragraph ("Nx generators are powerful tools... They ensure consistency across the codebase") explains what Claude already knows, and the 'This skill applies when' list repeats the frontmatter description. This is 'efficient; minor instances of over-explanation', not the every-token-earns-its-place level 5.

4 / 5

Actionability

Concrete, runnable commands throughout: `npx nx list @nx/react`, `npx nx g @nx/react:library --help`, the dry-run invocation, `node -e "console.log(require.resolve('@nx/<plugin>/generators.json'))"`, `npm run format`, and `nx run-many -t build,lint,test,typecheck`. A couple of spots remain templated or vague (step 7's `nx generate <generator-name> <options>` placeholder and 'Search the repo for the generator name'), which keeps it just below the fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

A clear 9-step sequence with explicit checkpoints and feedback loops: mandatory `--dry-run` before generating (step 6), a reconsider loop after reading generator source ('Is this the right generator? If not, go back to step 2'), and a verify-fix-escalate loop in step 9 with the practical caveat that generated spec files must be replaced or the test target removed. This matches the top anchor: clear sequence, explicit validation, and error-recovery guidance.

5 / 5

Progressive Disclosure

No bundle files exist, and the single file is cleanly sectioned into numbered steps with the one cross-skill pointer (link-workspace-packages) clearly signaled. It is above 160 lines, and some self-contained detail (the buildable/non-buildable table and its prose, and the `--directory` flag gotcha) could live in a reference file to slim SKILL.md, which is why it lands at 'good structure; minor organization gaps' rather than 5.

4 / 5

Total

17

/

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 strong, trigger-heavy description with explicit when-to-use guidance and good conflict resolution against nx_docs. Its main weakness is an under-specified 'what' — the capability list stops at 'generate code', omitting the scaffolding, migration, and boilerplate tasks the body actually covers.

Suggestions

Expand the 'what' clause to enumerate the skill's actual capabilities, e.g. 'Scaffold new apps and libraries, run workspace and plugin generators, and automate repetitive monorepo tasks using nx generators.'

Add a few missing natural trigger variations such as 'new library', 'scaffold a feature', or 'repo/workspace setup' to broaden keyword coverage.

Consider dropping the generic words 'setup' and 'structure' from the trigger list or qualifying them (e.g. 'project setup in an nx workspace') to reduce false triggers for non-nx requests.

DimensionReasoningScore

Specificity

"Generate code using nx generators" names the domain but only one concrete action — scaffolding projects, running migrations, and automating repetitive tasks (all covered in the body) are absent from the description. This matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor, not the level above which requires several specific listed actions.

3 / 5

Completeness

Both halves are present: a 'what' ("Generate code using nx generators") and an explicit 'when' ("INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs...") with concrete trigger words. The 'what' is thin — it omits what the body says the skill covers (scaffold features, migrations, custom generators) — so it does not fully reach the level-5 anchor of clearly and completely answering both.

4 / 5

Trigger Term Quality

Good natural-phrase coverage: "scaffolding", "create a ... app", "create a ... lib", "project structure", "add a new project", "generate" — exactly what a user would say. A few common variations (e.g., "new library", "migration", "bootstrap a workspace") are missing, keeping it below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The nx-generator niche is distinct, and "ALWAYS use this BEFORE calling nx_docs or exploring - this skill handles discovery internally" explicitly resolves overlap with the related docs skill. Broad trigger words like "setup", "generate", and "structure" carry minor risk of firing for non-nx scaffolding requests, so it stays at 'mostly distinct; minor overlap risk' rather than the minimal-conflict anchor 5.

4 / 5

Total

15

/

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
leboncoin/spark-web
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.