About

Imported from terminalskills/skills (skills/turborepo/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill turborepo. Copyright stays with the author (Apache-2.0).

Turborepo

Name: turborepo
Author: terminalskills

Overview

Turborepo is a high-performance build system for JavaScript/TypeScript monorepos that intelligently caches task outputs, parallelizes execution across CPU cores, and ensures teams only rebuild what has changed. It integrates with npm, yarn, and pnpm workspaces.

Instructions

When setting up a monorepo, define tasks in turbo.json with dependsOn for ordering, use ^ prefix for topological dependencies (e.g., "dependsOn": ["^build"]), and specify outputs for cacheable artifacts.
When configuring caching, define outputs arrays for each task (["dist/**", ".next/**"]), list all build-affecting environment variables in env or globalEnv, and set up Remote Cache for cross-developer sharing.
When filtering workspaces, use --filter=@app/web to target specific packages, --filter=...[HEAD~1] for changed packages, and turbo run build --graph to visualize the dependency graph.
When optimizing Docker builds, use turbo prune --scope=@app/web to generate a minimal Docker context containing only the targeted package and its dependencies.
When setting up CI/CD, enable Remote Cache for cross-PR cache sharing, use --dry-run=json for pipeline analysis, and leverage incremental builds that only rebuild packages affected by PR changes.
When organizing shared packages, create focused internal packages (@repo/ui, @repo/db, @repo/auth) with shared tsconfig and ESLint configs.

Examples

Example 1: Set up a new Turborepo monorepo

User request: "Initialize a monorepo with a Next.js app and shared UI library"

Actions:

Set up pnpm workspace with apps/web and packages/ui directories
Configure turbo.json with build, dev, lint, and typecheck tasks
Define task dependencies and cache outputs for each task
Create shared tsconfig base in packages/tsconfig

Output: A monorepo with parallel builds, intelligent caching, and shared configuration.

Example 2: Optimize Docker builds for deployment

User request: "Create a Dockerfile for deploying one service from our Turborepo monorepo"

Actions:

Run turbo prune --scope=@app/api to generate minimal context
Create multi-stage Dockerfile using the pruned output
Install dependencies and build only the targeted package
Configure cache mounts for faster rebuilds

Output: A lean Docker image containing only the service and its dependencies, not the full monorepo.

Guidelines

Always define outputs for cacheable tasks; use empty outputs: [] for side-effect-only tasks like lint.
List all environment variables in env or globalEnv that affect build output.
Use ^ prefix in dependsOn for tasks that consume dependency outputs (build, typecheck).
Keep internal packages small and focused: @repo/ui, @repo/db, @repo/auth.
Use turbo prune for Docker builds; never copy the entire monorepo into a container.
Set up Remote Cache in CI for cross-developer and cross-PR cache sharing.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-turborepo/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-turborepo.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-turborepo",
  "kind": "skill",
  "name": "turborepo",
  "description": "Assists with managing JavaScript/TypeScript monorepos using Turborepo. Use when configuring build pipelines, setting up caching, pruning workspaces for Docker, or optimizing CI/CD for monorepo projects. Trigger words: turborepo, turbo, monorepo, pipeline, workspace, remote cache, turbo.json.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "turborepo",
      "monorepo",
      "build-system",
      "caching",
      "ci-cd",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Assists with managing JavaScript/TypeScript monorepos using Turborepo. Use when configuring build pipelines, setting up caching, pruning workspaces for Docker, or optimizing CI/CD for monorepo projects. Trigger words: turborepo, turbo, monorepo, pipeline, workspace, remote cache, turbo.json."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/turborepo/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/turborepo/SKILL.md",
      "key": "terminalskills/skills/skills/turborepo/SKILL.md"
    },
    "compatibility": "Requires Node.js 16+ with npm, yarn, or pnpm",
    "license": "Apache-2.0"
  },
  "instructions": "# Turborepo\n\n## Overview\n\nTurborepo is a high-performance build system for JavaScript/TypeScript monorepos that intelligently caches task outputs, parallelizes execution across CPU cores, and ensures teams only rebuild what has changed. It integrates with npm, yarn, and pnpm workspaces.\n\n## Instructions\n\n- When setting up a monorepo, define tasks in `turbo.json` with `dependsOn` for ordering, use `^` prefix for topological dependencies (e.g., `\"dependsOn\": [\"^build\"]`), and specify `outputs` for cacheable artifacts.\n- When configuring caching, define `outputs` arrays for each task (`[\"dist/**\"",
  "cost": {
    "context_tokens": 752
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-turborepo/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.