CtrlK
BlogDocsLog inGet started
Tessl Logo

nx-plugin-authoring

Create Nx plugins with custom generators and executors for TypeScript monorepos. Covers plugin scaffolding, Tree API usage, schema-driven options, ExecutorContext API, template generation, project-graph-safe updates, cache-aware outputs, and testable workflows. Use when creating Nx plugins, building custom generators, implementing executors, enforcing conventions, or extending Nx workspace automation.

68

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured, actionable hub: concise anti-patterns with WHY/BAD/GOOD, a validated four-step workflow, and concrete commands throughout. The main defect is that three referenced knowledge-base files are missing from the bundle, leaving broken links in the References section; secondary gaps are duplicated command listings and missing registration snippets.

Suggestions

Fix or remove the three dangling references to knowledge-base/concepts.md, knowledge-base/template-system.md, and knowledge-base/utilities.md — either add the files to the bundle or repoint those rows at existing references/ files.

Drop the "Quick Commands" section (it duplicates commands already shown in the Workflow steps) or reduce it to the few commands not previously demonstrated, such as `npx nx reset` and the `rg` search.

Add a short executable example of generator/executor registration (generators.json / executors.json entry plus the src/index.ts export) to close the main actionability gap.

DimensionReasoningScore

Conciseness

The body is lean — short bullets, compact WHY/BAD/GOOD anti-pattern entries, and no explanations of concepts Claude already knows. It is not a 5 because the "Quick Commands" section repeats commands already shown in the Workflow section (e.g. `npx create-nx-plugin my-plugin`, `npx nx add @nx/plugin`, `npx nx g generator ...`), and the "Navigation hub for..." intro line adds little.

4 / 5

Actionability

Most guidance is executable: concrete CLI commands (`npx nx g my-plugin:library-with-readme mylib --dry-run`, `npx nx run my-project:my-target --skip-nx-cache`) and concrete GOOD code like `readProjectConfiguration(tree, name).root` and `"outputs": ["{options.outputPath}"]`. It is not a 5 because several generator/executor steps remain high-level hints ("Use package notation for registration", "Define typed schema with required fields") without a generators.json/executors.json registration snippet or a schema example.

4 / 5

Workflow Clarity

The four-step workflow (Create Plugin Structure → Build Generators → Build Executors → Test and Publish) is clearly sequenced with explicit **Validate** commands and **Stop if** abort criteria at each step. It is not a 5 because there are no feedback loops for error recovery — "Stop if" states when to abort but not how to diagnose and retry, and the test step has no pass/fail follow-up.

4 / 5

Progressive Disclosure

The hub structure is good — topic-to-file tables with one-level-deep, clearly signaled references — but 3 of the 12 internal links (knowledge-base/concepts.md, knowledge-base/template-system.md, knowledge-base/utilities.md) point to a directory that does not exist in the bundle, so a quarter of the navigation targets are broken. The structure is better organized than the anchor-3 example (references are clearly signaled, not buried), but broken reference targets impair navigation enough to rule out a 4.

3 / 5

Total

15

/

20

Passed

Description

96%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 description: third-person voice, dense with concrete capability statements, and an explicit multi-trigger 'Use when' clause covering the natural ways users would request this skill. The only risk is mild overlap with broader Nx workspace-automation skills via the final trigger phrase.

DimensionReasoningScore

Specificity

The description lists many specific concrete actions — "plugin scaffolding, Tree API usage, schema-driven options, ExecutorContext API, template generation, project-graph-safe updates, cache-aware outputs, and testable workflows" — giving comprehensive coverage of the skill's capabilities rather than vague language. It is not the level below (4) because there are no significant gaps in the action inventory for this domain.

5 / 5

Completeness

It explicitly answers both questions: 'what' via "Create Nx plugins with custom generators and executors... Covers plugin scaffolding, Tree API usage..." and 'when' via an explicit "Use when creating Nx plugins, building custom generators, implementing executors, enforcing conventions, or extending Nx workspace automation" clause with concrete trigger phrases. Both halves are present and explicit, matching the top anchor exactly.

5 / 5

Trigger Term Quality

The "Use when" clause covers the natural phrases a user would say: "creating Nx plugins, building custom generators, implementing executors, enforcing conventions, or extending Nx workspace automation" — matching how users actually request this work. It falls short of nothing meaningful in this domain; synonym coverage (creating/building/extending) is present, and file extensions are not applicable to plugin authoring.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — authoring plugins ("Create Nx plugins with custom generators and executors") — and triggers are creation-oriented, distinguishing it from skills about using existing Nx plugins or generic workspace setup. It is not a 5 because "extending Nx workspace automation" is broad enough to overlap with general Nx configuration or workspace-automation skills.

4 / 5

Total

19

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository
pantheon-org/tekhne
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.