CtrlK
BlogDocsLog inGet started
Tessl Logo

nx-workspace-patterns

Configure and optimize Nx monorepo workspaces with deterministic project-graph structure, boundary enforcement, cache-aware pipelines, and affected-command CI workflows; use when designing workspace architecture, tightening dependency rules, or reducing CI cost through Nx task orchestration.

72

Quality

89%

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

86%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-built hub skill: executable commands and complete config examples, a sequenced workflow with an explicit lint-validation checkpoint, and clean one-level-deep references that were verified to exist. The only tightening opportunities are trimming slightly redundant anti-pattern rationale and adding an error-recovery pointer for CI base/head failures.

Suggestions

Trim the WHY/BAD lines in Anti-Patterns to the ones that add non-obvious rationale (e.g., the cache-inputs and dependsOn entries) — the circular-dependency and inconsistent-tags entries largely restate the GOOD guidance.

Add a feedback-loop step to the Workflow for CI failures, e.g. 'If affected scope looks wrong, verify fetch depth and base/head derivation — see references/affected-commands.md#troubleshooting'.

Fold the 'When Not to Use' bullets into the description's trigger clause or a single line, since they partially duplicate the frontmatter's scope signaling.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Nx competence — no primer on what Nx or a monorepo is — with dense tables for fallbacks and terse constraint bullets. A few anti-pattern WHY/BAD lines restate what a competent model could infer ('cycles degrade graph clarity', 'mixed ad hoc tags with no vocabulary'), keeping it at 'efficient; minor instances of over-explanation' (anchor 4) rather than the every-token-earns-its-place anchor; not 3 because there is no genuinely unnecessary explanatory padding.

4 / 5

Actionability

Guidance is fully executable: copy-paste commands ('nx affected -t lint,test,build --base=origin/main --parallel=3', 'rg -n "@nx/enforce-module-boundaries|depConstraints" .') plus complete, ready-to-use nx.json targetDefaults and ESLint depConstraints JSON examples covering the common cases. This matches the top anchor and exceeds the 'minor gaps' level.

5 / 5

Workflow Clarity

The five-step workflow is clearly sequenced and includes one explicit validation checkpoint ('verify violations fail with nx lint --skip-nx-cache'), matching 'clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because there are no error-recovery/feedback loops for the remaining steps (e.g., what to do when affected scope or base/head resolution is wrong in CI), though the no-validation cap at 3 does not apply since an explicit verification step exists and operations are non-destructive.

4 / 5

Progressive Disclosure

The body is a genuine navigation hub: quick commands and one example each inline, with a labeled reference table pointing to four real, one-level-deep files (project-graph-configuration.md, caching-strategies.md, project-boundaries.md, affected-commands.md — all verified present and appropriately scoped), plus curated external links. This matches 'clear overview with well-signaled one-level-deep references; easy navigation'.

5 / 5

Total

18

/

20

Passed

Description

92%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: it names the domain, enumerates concrete capabilities, and closes with an explicit multi-scenario 'use when' clause in third person. The only gap is a few missing natural trigger synonyms (e.g., config file names like nx.json) that would push trigger coverage from good to comprehensive.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'deterministic project-graph structure', 'boundary enforcement', 'cache-aware pipelines', and 'affected-command CI workflows' — giving comprehensive coverage of what the skill does. It matches the 'lists multiple specific concrete actions; comprehensive coverage' anchor and is clearly above the 'several specific actions; minor gaps' level.

5 / 5

Completeness

It explicitly answers both 'what' ('Configure and optimize Nx monorepo workspaces with...') and 'when' ('use when designing workspace architecture, tightening dependency rules, or reducing CI cost through Nx task orchestration') with concrete trigger phrases. This is a direct match to the top anchor; the level-4 anchor's 'when could be more explicit' caveat does not apply since the when-clause enumerates three specific scenarios.

5 / 5

Trigger Term Quality

Natural phrases like 'Nx monorepo', 'workspace architecture', 'dependency rules', and 'reducing CI cost' mirror what users would actually say, but there are no file/config triggers (e.g., 'nx.json', 'affected') or common synonyms. This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The 'Nx' niche is explicit and the triggers (project graph, module boundaries, affected commands) are distinct to Nx task orchestration, giving minimal conflict risk with adjacent CI or build skills. It sits clearly at 'clear niche with distinct triggers' and above the 'minor overlap risk' level.

5 / 5

Total

19

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.