Content
78%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-engineered reference skill: decision trees, WRONG/CORRECT examples, and a verified one-level-deep reference bundle make it highly actionable and navigable. The main costs are duplication — the turbo-run-vs-shorthand rule is stated twice with near-identical examples — and a pinned canary version in the schema URL that will age.
Suggestions
Merge the 'Secondary Rule: turbo run vs turbo' section and the 'Using `turbo` Shorthand in Code' anti-pattern into a single statement with one example set, deleting the duplicated WRONG/CORRECT JSON and YAML blocks.
Consolidate the .env / globalDependencies guidance spread across 'Overly Broad globalDependencies', 'With Environment Variables', and 'Root .env File' into one environment/cache-invalidation section, or point the later occurrences at references/environment/gotchas.md instead of restating examples.
Move the pinned version references (metadata version 2.9.17-canary.3 and the $schema URL 'https://v2-9-17-canary-3.turborepo.dev/schema.json') out of inline examples — use the unversioned 'https://turbo.build/repo/schema.json' style or confine version mentions to a clearly labeled version-notes area.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Turborepo-specific knowledge and avoids generic filler, but it is noticeably repeated: the 'turbo run vs turbo shorthand' rule appears in full (with WRONG/CORRECT JSON and YAML examples) both in 'Secondary Rule: turbo run vs turbo' and again in 'Using `turbo` Shorthand in Code', and .env/globalDependencies guidance recurs across 'Overly Broad globalDependencies', 'With Environment Variables', and 'Root .env File'. It also embeds a time-sensitive pinned version ("https://v2-9-17-canary-3.turborepo.dev/schema.json") outside any deprecated/old-patterns section. This fits 'mostly efficient but could be tightened' rather than the noticeably-padded anchor 2. | 3 / 5 |
Actionability | Nearly every rule ships copy-paste-ready JSON/YAML/bash with explicit WRONG vs CORRECT pairs (e.g., package tasks vs root tasks turbo.json examples, `$TURBO_ROOT$` input fixes, `turbo run build --affected`), plus concrete heuristics like common outputs by framework. Guidance is fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | As a guidance skill it routes work through ten explicit decision trees and embeds check-before-acting verification steps ("Before flagging missing `outputs`, check what the task actually produces" with a 3-step procedure; the prebuild fix branches on whether workspace dependencies are declared). It lacks the explicit validate-then-proceed feedback loops of the 5 anchor — e.g., cache debugging points at --summarize/--dry but no retry-on-failure loop — which is a minor gap rather than an absent sequence. | 4 / 5 |
Progressive Disclosure | The bundle matches the ideal structure: SKILL.md is the overview with a categorized Reference Index table (file + purpose) for all 25 reference files, decision trees link to specific files and anchors (e.g., references/configuration/tasks.md#outputs), every referenced path verified to exist, and reference files link only to siblings one level deep with no nested chains. Navigation is easy and content is appropriately split. | 5 / 5 |
Total | 17 / 20 Passed |