CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

monorepo-architect

Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup,

Quality

63%

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 ./skills/monorepo-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 cleanly sectioned but generic overview that reads like a template: it lists capabilities and best practices without a single executable command, config snippet, or concrete example, and its one external reference points to a nonexistent file. Claude would gain little beyond what it already knows about monorepos.

Suggestions

Add executable guidance: concrete commands and config examples such as `npx create-nx-workspace`, a minimal turbo.json/nx.json snippet, and affected-command invocations for CI.

Fix or remove the dangling `resources/implementation-playbook.md` reference — no such file exists in the bundle; either ship the playbook or drop the pointer.

Insert validation checkpoints into the Workflow (e.g., 'verify the dependency graph renders correctly', 'confirm cache hits on a second build before enabling remote caching in CI') and drop the boilerplate Instructions/Do-not-use filler.

DimensionReasoningScore

Conciseness

The body is terse and does not explain concepts Claude already knows, but it contains boilerplate padding — 'Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes' and the vacuous 'The task is unrelated to monorepo architect' — that earns no token value.

3 / 5

Actionability

Guidance stays at the level of high-level hints ('Select appropriate monorepo tooling', 'Configure build caching strategy', 'Implement task pipelines') with no executable commands, config examples (nx.json, turbo.json), or file formats. A sequenced workflow exists, so it rises above anchor 1, but it never gives the specific steps to execute.

2 / 5

Workflow Clarity

The 8-step Workflow section is coherently ordered (assess → select tooling → design structure → configure caching → ... → document), but steps are abstract and no validation checkpoints or feedback loops appear (e.g., nothing verifies caching or affected-detection works before wiring CI).

3 / 5

Progressive Disclosure

Sections are well organized and the single external reference is clearly signaled one level deep ('If detailed examples are required, open resources/implementation-playbook.md'), but that file does not exist in the bundle — the only pointer out of SKILL.md is dangling, breaking navigation.

3 / 5

Total

11

/

20

Passed

Description

68%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 reasonably distinctive, domain-specific description with decent trigger terms, undermined by a truncated 'Use PROACTIVELY for monorepo setup,' clause and by capability framing ('Expert in', 'Masters') that states credentials rather than concrete actions.

Suggestions

Complete the truncated trigger clause — the description is cut off mid-sentence at 'Use PROACTIVELY for monorepo setup,'; finish the enumeration (e.g., '...setup, build optimization, CI speedups, or polyrepo-to-monorepo migration').

Replace credential-style claims ('Expert in', 'Masters') with concrete actions such as 'Sets up Nx/Turborepo/Bazel/Lerna workspaces, configures remote build caching, and manages cross-project dependency graphs'.

Add natural trigger phrases users would actually say, like 'polyrepo to monorepo', 'slow CI builds', or 'sharing code between apps', to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('monorepo architecture, build systems, and dependency management') and four tools ('Nx, Turborepo, Bazel, and Lerna'), but 'Expert in' and 'Masters' are role claims rather than concrete actions — no specific actions like configuring workspaces, migrating repos, or setting up caching are stated.

2 / 5

Completeness

Both 'what' (monorepo architecture, build systems, dependency management expertise across four named tools) and 'when' ('Use PROACTIVELY for monorepo setup') are explicitly present. The trigger clause is truncated mid-enumeration ('...for monorepo setup,'), leaving the 'when' guidance incomplete rather than fully concrete, which keeps it at anchor 4 instead of 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage including 'monorepo', 'monorepo setup', 'build systems', 'dependency management', and the four tool names users would naturally say. Common variations like 'polyrepo to monorepo migration', 'slow CI', or 'shared code between apps' are missing, so it falls short of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (monorepo build tooling) with four distinctly named tools and an explicit 'monorepo setup' trigger; virtually no other skill category would collide with these terms.

5 / 5

Total

15

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/monorepo-architect/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.