CtrlK
BlogDocsLog inGet started
Tessl Logo

turborepo

Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines, dependsOn, caching, remote cache, the "turbo" CLI, --filter, --affected, CI optimization, environment variables, internal packages, monorepo structure/best practices, and boundaries. Use when user: configures tasks/workflows/pipelines, creates packages, sets up monorepo, shares code between apps, runs changed/affected packages, debugs cache, or has apps/packages directories.

83

1.36x
Quality

77%

Does it follow best practices?

Impact

94%

1.36x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/turborepo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 clear 'when to use' guidance. Its main weakness is that the 'what' portion describes topics and concepts rather than concrete actions the skill performs. The description would benefit from rephrasing topic lists into action-oriented capability statements.

Suggestions

Rephrase the capability section to list concrete actions rather than topics, e.g., 'Configures task pipelines in turbo.json, sets up remote caching, optimizes CI builds, debugs cache issues' instead of listing concepts like 'caching, remote cache, CI optimization'.

DimensionReasoningScore

Specificity

The description names the domain (Turborepo monorepo build system) and mentions several concepts like task pipelines, caching, remote cache, CI optimization, but doesn't list concrete actions the skill performs (e.g., 'configure task pipelines', 'set up remote caching', 'debug cache misses'). It reads more like a topic list than a list of specific capabilities.

2 / 3

Completeness

The description clearly answers both 'what' (Turborepo monorepo build system guidance) and 'when' with an explicit 'Use when user:' clause listing multiple concrete trigger scenarios like configuring tasks, creating packages, debugging cache, and working with apps/packages directories.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say: 'turbo.json', 'dependsOn', 'caching', 'remote cache', '--filter', '--affected', 'CI optimization', 'monorepo', 'apps/packages directories'. These are highly specific terms a user working with Turborepo would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with Turborepo-specific terms like 'turbo.json', 'dependsOn', '--filter', '--affected', and 'turbo CLI' that are unlikely to conflict with other skills. The niche is clearly defined and would not overlap with general monorepo or build system skills.

3 / 3

Total

11

/

12

Passed

Implementation

64%

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

This is a comprehensive and highly actionable Turborepo skill with excellent concrete examples and decision trees for common scenarios. Its main weakness is that it functions more as a complete reference than an overview document — significant content (anti-patterns, task configurations) should be moved to the referenced files to improve conciseness and progressive disclosure. Adding explicit validation steps (e.g., 'run turbo run build --dry to verify task graph') would strengthen workflow clarity.

Suggestions

Move the extensive anti-patterns section and common task configurations to separate reference files (e.g., references/configuration/gotchas.md), keeping only the top 2-3 most critical anti-patterns inline with brief summaries pointing to the full list.

Add explicit validation checkpoints to key workflows, e.g., 'After configuring tasks, verify with `turbo run build --dry` to confirm the dependency graph is correct' or 'Use `turbo run build --summarize` to verify cache inputs include expected environment variables.'

Trim explanatory prose that Claude can infer — for example, the 'Problems with root .env' bullet list and the 'Benefits of Package Configurations' section could be reduced to single-line notes.

DimensionReasoningScore

Conciseness

The skill is quite long with extensive anti-pattern examples that include both WRONG and CORRECT versions, which is valuable but verbose. Some sections like the root .env anti-pattern explanation include rationale Claude could infer ('Bad habits start small — starter templates should model correct patterns'). The decision trees are efficient, but the sheer volume of inline content (anti-patterns, task configurations) could be trimmed or moved to reference files.

2 / 3

Actionability

Every pattern and anti-pattern includes concrete, copy-paste-ready JSON configuration examples. The decision trees point to specific files and flags. Commands like `turbo run build --affected` and configuration snippets are fully executable and specific.

3 / 3

Workflow Clarity

The decision trees provide clear navigation for common scenarios, and the task configuration section shows sequenced patterns. However, there are no explicit validation checkpoints — for example, when setting up a new task pipeline or debugging cache issues, there's no 'verify by running X' step. Cache debugging mentions --summarize and --dry but only as references, not as part of a validate-fix-retry workflow.

2 / 3

Progressive Disclosure

The Reference Index at the bottom is excellent with well-organized one-level-deep references. However, the SKILL.md itself contains a massive amount of inline content (anti-patterns, task configurations, environment variable patterns) that would be better placed in the referenced files. The decision trees effectively serve as navigation, but the body is too long for an overview document.

2 / 3

Total

9

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (952 lines); consider splitting into references/ and linking

Warning

Total

10

/

11

Passed

Repository
vercel/turborepo
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.