Agent skill · Workflow & Productivity

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.

antfugithub.com/antfuGitHub ↗
claude-codeMIT
Install
npx skills add antfu/skills --skill turborepo --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 28
SKILL.md size: 27 KB
Bundled scripts: none
Version: 2.9.19-canary.9
Path: skills/turborepo/SKILL.md
Open the folder on GitHub →
Where it comes from
Source: antfu/skills
Stars: 5,709
Language: TypeScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Turborepo Skill Build system for JavaScript/TypeScript monorepos. Turborepo caches task outputs and runs tasks in parallel based on dependency graph. ## IMPORTANT: Package Tasks, Not Root Tasks **Prefer package tasks over Root Tasks.** When creating tasks/scripts/pipelines, you MUST default to package tasks: 1. Add the script to each relevant package's `package.json` 2. Register the task in root `turbo.json` 3. Root `package.json` only delegates via `turbo run <task>` **DO NOT** put task logic in root `package.json` when it can live in packages. This defeats Turborepo's parallelization. ```json // DO THIS: Scripts in each package // apps/web/package.json { "scripts": { "build": "next build", "lint": "eslint .", "test": "vitest" } } // apps/api/package.json { "scripts": { "build": "tsc", "lint": "eslint .", "test": "vitest" } } // packages/ui/package.json { "scripts": { "build": "tsc", "lint": "eslint .", "test": "vitest" } } ``` ```json // turbo.json - register tasks { "tasks": { "build": { "dependsOn": ["^build"], "outputs": ["dist/**"] }, "lint": {}, "test": { "dependsOn": ["build"] } } } ``` ```json // Root package.json - ONLY delegates, no task logic { "scripts": { "build": "

What's inside
Steps it walks through
  1. IMPORTANT: Package Tasks, Not Root Tasks
  2. Secondary Rule: turbo run vs turbo
  3. Quick Decision Trees
  4. "I need to configure a task"
  5. "My cache isn't working"
  6. "I want to run only changed packages"
  7. "I want to filter packages"
  8. "Environment variables aren't working"
  9. "I need to set up CI"
  10. "I want to watch for changes during development"
  11. "I need to create/structure a package"
  12. "How should I structure my monorepo?"
  13. "I want to enforce architectural boundaries"
  14. Critical Anti-Patterns
Ships with 24 files
  • LICENSE.md
  • SYNC.md
  • command/turborepo.md
  • references/best-practices/RULE.md
  • references/best-practices/dependencies.md
  • references/best-practices/packages.md
  • references/best-practices/structure.md
  • references/boundaries/RULE.md
  • references/caching/RULE.md
  • references/caching/gotchas.md
  • references/caching/remote-cache.md
  • references/ci/RULE.md
  • references/ci/github-actions.md
  • references/ci/patterns.md
  • references/ci/vercel.md
  • references/cli/RULE.md
  • references/cli/commands.md
  • references/configuration/RULE.md
  • references/configuration/global-options.md
  • references/configuration/gotchas.md
  • references/configuration/tasks.md
  • references/environment/RULE.md
  • references/environment/gotchas.md
  • references/environment/modes.md
first 24 of 28
Commands it runs
WRONG - bypasses dependency graph
turbo run lint --parallel
CORRECT - configure tasks to allow parallel execution
In turbo.json, set dependsOn appropriately (or use transit nodes)
turbo run lint
More from skills
All skills →
About this skill
What does the turborepo skill do?

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.

How do I install it?

Run `npx skills add antfu/skills --skill turborepo --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From antfu/skills, a repository with 5,709 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going