CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

74%

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 ./.github/skills/nx-generate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 a strong, well-sequenced workflow with concrete commands, explicit dry-run and verification checkpoints, and genuine error-recovery loops including when to abandon the skill and escalate. Its main weakness is token efficiency: a conceptual intro, a buildability tutorial, and repeated caveats pad out otherwise lean instruction.

Suggestions

Cut the conceptual intro paragraph and the buildability explanation bullets ("Have their own build target", "Required for npm publishing") — Claude already knows what buildable libraries are; keep only the workspace policy (default to non-buildable), the flag table, and the clarifying question.

State the "targets are just an example, check what this workspace uses" caveat once instead of repeating it in steps 4, 7's note, and 9.

Consider moving the `--directory` behavior gotcha and the buildability guidance into a references/ file so SKILL.md stays a lean overview with one-level-deep pointers.

DimensionReasoningScore

Conciseness

Mostly efficient and command-driven, but several passages explain concepts Claude already knows: the intro ("Nx generators are powerful tools that scaffold projects... They ensure consistency across the codebase"), the buildability tutorial bullets ("Have their own build target", "Useful for stable libs that rarely change (cache hits)", "Required for npm publishing"), and the repeated caveat "these targets are just an example" stated twice in steps 4 and 9. Not 4 because there are several distinct padded passages rather than minor instances; not 2 because the bulk of the body is lean, actionable instruction.

3 / 5

Actionability

Nearly every step carries an executable command: `npx nx list @nx/react`, `npx nx g @nx/react:library --help`, `node -e "console.log(require.resolve('@nx/<plugin>/generators.json'));"`, `npx nx g @nx/react:library --name=my-lib --dry-run --no-interactive`, `nx format --fix`, and `nx run-many -t build,lint,test,typecheck`, plus concrete correct/incorrect `--directory` examples. Not 5 because the core run command (`nx generate <generator-name> <options> --no-interactive`) and the `@nx/<plugin>` placeholder are templates rather than concrete copy-paste examples; not 3 because the guidance is genuinely executable with only minor gaps.

4 / 5

Workflow Clarity

A clear 9-step sequence with explicit validation checkpoints ("Always run with `--dry-run` first to verify files will be created in the correct location", format-and-verify in step 9) and genuine feedback loops: "If verification fails with manageable issues (a few lint errors, minor type issues), fix them" with an escalation path, and "After reading the source, reconsider: Is this the right generator? If not, go back to step 2". This matches the anchor-5 pattern of explicit validation plus error-recovery loops; nothing is missing for a 4.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories) and all references in the body are to commands or one cross-skill pointer ("The `link-workspace-packages` skill can help"), so there are no dangling or nested file references. Section structure is clear and easy to navigate. Not 5 because at ~167 lines with self-contained tutorial content (the buildability table and explanation, the `--directory` gotcha block) it is more than a lean overview that could split detail into a reference file; not 3 because the structure is good and nothing that clearly belongs in a separate file is buried or unorganized.

4 / 5

Total

16

/

20

Passed

Description

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

The description has strong, explicit trigger guidance with good natural-phrase coverage, but the capability statement itself is thin ("Generate code using nx generators") and written in an aggressive second-person imperative voice that the rubric penalizes. Overly broad trigger words like "setup" and "structure" create moderate conflict risk with non-nx skills.

Suggestions

Rewrite in third-person declarative voice, e.g., "Scaffolds apps and libraries and runs workspace or plugin generators in an Nx monorepo" instead of imperative commands like "INVOKE IMMEDIATELY" and "ALWAYS use this BEFORE calling nx_docs".

Broaden the what-clause to enumerate concrete capabilities (create apps/libs, run custom workspace generators, automate migrations) rather than the single generic action "Generate code using nx generators".

Tie broad trigger words ("setup", "structure", "generate") to the Nx/monorepo context, e.g., "when the user wants to create a new app or lib in an Nx workspace", to reduce conflict with unrelated skills.

DimensionReasoningScore

Specificity

"Generate code using nx generators" names the domain with only a minimal, generic action, matching the anchor-3 example pattern ("Processes PDF files and extracts content"); additionally the second-person imperative voice ("INVOKE IMMEDIATELY", "ALWAYS use this") incurs the rubric's -1 voice penalty, bringing 3 down to 2. Not 1 because the domain and a concrete action are named; not 3 or 4 because the what-clause lists only one action and the voice penalty applies.

2 / 5

Completeness

Both parts are explicit: what = "Generate code using nx generators", when = "INVOKE IMMEDIATELY when user mentions scaffolding, setup, structure, creating apps/libs, or setting up project structure" with concrete trigger phrases, so the anchor-3 cap for missing trigger guidance does not apply. Not 5 because the what-clause is thin compared to the anchor-5 example's comprehensive multi-action list (it never conveys apps, libs, custom generators, or migrations as capabilities); not 3 because the when-clause is fully explicit.

4 / 5

Trigger Term Quality

Trigger terms "scaffold, setup, create a ... app, create a ... lib, project structure, generate, add a new project" plus "scaffolding, setup, structure, creating apps/libs" give good natural-phrase coverage with synonyms a user would actually say. Not 5 because a few natural variations are missing (e.g., "new project", "bootstrap", framework-specific phrasing); not 3 because common natural phrases are well represented rather than merely "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

The niche "nx generators" is clearly named, but the instruction to invoke on bare words like "setup", "structure", and "generate" creates real overlap risk with unrelated scaffolding, configuration, or code-generation skills. Not 4 because the overlap risk is more than minor given the unqualified generic trigger words; not 2 because the explicit nx domain keeps it from being broadly conflicting with "many similar skills".

3 / 5

Total

13

/

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

mlbymolly/ruview-t4est

Path

.github/skills/nx-generate/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.