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 new app, create a new lib, project structure, generate, add a new project. ALWAYS use this BEFORE calling nx_docs or exploring - this skill handles discovery internally.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/nx-generate/SKILL.md

Quality

Content

70%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid, well-structured skill with an excellent multi-step workflow that includes proper validation checkpoints (dry-run, format, verify) and error recovery paths. Its main weaknesses are moderate verbosity—explaining concepts Claude likely knows (what generators are, what buildable vs non-buildable means conceptually) and some sections that could be more concise. The progressive disclosure is adequate but could benefit from splitting detailed reference material (buildability guidance, directory flag behavior) into separate files.

Suggestions

Remove the opening paragraph explaining what Nx generators are and the 'This skill applies when' list—this is already covered by the skill's trigger description in frontmatter.

Consider moving the Library Buildability table and the directory flag warning into a separate reference file (e.g., NX_GENERATOR_GOTCHAS.md) to keep the main workflow lean.

Trim explanatory sentences like 'Non-buildable libs: Export .ts/.tsx source directly, Consumer's bundler compiles them' which explain concepts Claude already understands.

Dimension	Reasoning	Score
Conciseness	The skill contains some unnecessary explanations (e.g., the opening paragraph explaining what Nx generators are, the detailed buildability table that Claude could reason about). The directory flag warning and library buildability sections add value but could be more concise. Several sections include explanatory text that could be trimmed.	3 / 5
Actionability	Provides concrete CLI commands throughout (nx list, nx g with --help, --dry-run, --no-interactive flags), specific examples for directory flag gotchas, and clear verification commands. Minor gaps include not showing complete end-to-end example output and relying on generic placeholder commands for verification.	4 / 5
Workflow Clarity	Excellent 9-step sequential workflow with explicit validation checkpoints: dry-run before execution (step 6), format and verify after generation (step 9), feedback loop for fixing issues or escalating to user. The workflow includes clear decision points (step 2 reconsideration, step 4 reconsideration) and error recovery guidance.	5 / 5
Progressive Disclosure	The skill is a single monolithic file with no bundle files or references to supporting documents (except a mention of 'link-workspace-packages' skill). The buildability table and directory flag details could be split into reference files. At ~120 lines, it's borderline for needing separation, but the inline detail level suggests some content could be better organized into supplementary files.	3 / 5
	Total	15 / 20 Passed

Description

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

This is a solid skill description with excellent trigger term coverage and completeness, including explicit 'when' guidance and priority ordering relative to related skills. Its main weakness is that the 'what' portion is somewhat thin—it says 'generate code using nx generators' without elaborating on the specific types of outputs (apps, libraries, configurations). The all-caps imperative language (INVOKE IMMEDIATELY, ALWAYS) is unusual but functional for disambiguation.

Suggestions

Expand the capability description to list specific outputs, e.g., 'Generate apps, libraries, and project configurations using nx generators' to improve specificity.

Dimension	Reasoning	Score
Specificity	Names the domain (nx generators) and one concrete action (generate code), but doesn't elaborate on what kinds of code or structures can be generated. The trigger words list adds context but doesn't describe specific capabilities like 'create apps, libraries, configure workspaces'.	3 / 5
Completeness	Clearly answers both 'what' (generate code using nx generators) and 'when' (explicit 'INVOKE IMMEDIATELY when...' clause with concrete trigger phrases). Also includes priority guidance about using this skill before other related skills.	5 / 5
Trigger Term Quality	Excellent coverage of natural trigger terms including 'scaffold', 'setup', 'create a new app', 'create a new lib', 'project structure', 'generate', 'add a new project'. These are phrases users would naturally say when needing this skill, and synonyms are well covered.	5 / 5
Distinctiveness Conflict Risk	Fairly distinct with the nx generators niche and explicit differentiation from 'nx_docs' skill. However, terms like 'scaffold', 'setup', and 'generate' are somewhat generic and could overlap with non-nx code generation skills. The explicit priority instruction helps reduce conflict with the nx_docs skill specifically.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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.

Repository: whimzyLive/nightshift-ai
Path: .github/skills/nx-generate/SKILL.md
Commit: 7741177

Reviewed: 10 days ago

Table of Contents

Discovery Implementation Validation

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.