К основному содержанию
скилл CX Codex

turborepo · oakoss — скилл для Claude Code: настройка и установка

Скилл для Claude Code помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI.

MIT 108 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill turborepo -a claude-code
Открыть на GitHub

Что делает turborepo

Скилл помогает настраивать сборку и выполнение задач в монорепозитории на JavaScript или TypeScript. Он разбирает зависимости задач через dependsOn, кэширование, переменные окружения и фильтры для выбора пакетов. Конфигурация хранится в turbo.json или turbo.jsonc.

Для разных пакетов можно задать отдельные настройки, а turbo generate помогает создавать пакеты и компоненты. Команда turbo boundaries проверяет границы пакетов, а turbo query показывает граф зависимостей. Скилл рассчитан на монорепозитории с шагами сборки: для одного пакета и проектов не на JavaScript он не предназначен.

Какие задачи решает

  • настроить порядок выполнения задач через dependsOn
  • разобраться с промахами кэша и его входными данными
  • запустить задачи только для изменённых пакетов
  • задать переменные окружения, влияющие на кэш
  • создать пакет или компонент через генератор

Примеры запросов агенту

  • Настрой turbo.json, чтобы зависимости пакетов собирались до основной задачи.
  • Разберись, почему задачи постоянно промахиваются мимо кэша.
  • Запусти задачи для изменённых пакетов и их зависимых пакетов.

Как установить turborepo

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill turborepo -a claude-code

2Вручную: положить файлы

~/.claude/skills/turborepo/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/turborepo/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о turborepo

Как установить turborepo в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill turborepo -a claude-code. Файл скилла находится в ~/.claude/skills/turborepo/SKILL.md.

Что делает turborepo?

Скилл помогает настроить Turborepo для монорепозитория на JavaScript или TypeScript: зависимости задач, кэш, фильтрацию пакетов и конфигурацию рабочих пространств.

Для каких проектов подходит turborepo?

Для монорепозиториев на JavaScript или TypeScript, в которых есть шаги сборки. Для проектов из одного пакета и монорепозиториев на других языках он не предназначен.

Исходный текст

SKILL.md · MIT
---
name: turborepo
description: |
  Turborepo monorepo build system and orchestration. Covers task pipelines, dependsOn syntax, caching configuration, remote cache, filtering, CI optimization, environment variables, workspace management, watch mode, package boundaries, and code generation.

  Use when configuring tasks, creating packages, setting up monorepo, sharing code between apps, running changed packages, debugging cache, optimizing CI, resolving workspace dependencies, enforcing package boundaries, or generating code.
license: MIT
metadata:
  author: oakoss
  version: '1.2'
user-invocable: false
---

# Turborepo

## Overview

Build system for JavaScript/TypeScript monorepos. Caches task outputs and runs tasks in parallel based on dependency graph. Always create package tasks (not root tasks), use `turbo run` in scripts, and let `dependsOn` manage execution order. Configuration uses `turbo.json` (or `turbo.jsonc` for comments).

**When to use:** Monorepo task orchestration, build caching, CI optimization, workspace dependency management, package boundary enforcement.

**When NOT to use:** Single-package projects, non-JavaScript monorepos, projects without build steps.

## Quick Reference

| Pattern                 | Syntax                                           | Key Points                                      |
| ----------------------- | ------------------------------------------------ | ----------------------------------------------- |
| Schema                  | `"$schema": "https://turborepo.dev/schema.json"` | Always include in turbo.json                    |
| Dependency build        | `"dependsOn": ["^build"]`                        | Build dependencies first                        |
| Same-package task       | `"dependsOn": ["codegen"]`                       | Run in same package first                       |
| Specific package        | `"dependsOn": ["pkg#task"]`                      | Named package's task                            |
| Parallel lint/typecheck | Transit Nodes pattern                            | Cache invalidation without sequential execution |
| Dev server              | `"persistent": true, "cache": false`             | Long-running, non-cacheable                     |
| Sidecar tasks           | `"with": ["api#dev"]`                            | Run tasks concurrently alongside                |
| Watch mode              | `turbo watch dev`                                | Re-run on file changes                          |
| Filter by package       | `--filter=web`                                   | Single package                                  |
| Filter with deps        | `--filter=web...`                                | Package + dependencies                          |
| Changed packages        | `--affected`                                     | Changed + dependents                            |
| Debug cache             | `--summarize` or `--dry`                         | See hash inputs                                 |
| Package config          | `turbo.json` with `"extends": ["//"]`            | Per-package overrides                           |
| Composable config       | `"extends": ["@repo/config"]`                    | Extend from any workspace package               |
| Extend arrays           | `"$TURBO_EXTENDS$"` in arrays                    | Append to inherited config instead of replacing |
| Env vars in hash        | `"env": ["API_URL"]`                             | Cache invalidation on change                    |
| Boundaries              | `turbo boundaries`                               | Enforce package isolation and import rules      |
| Query graph             | `turbo query`                                    | GraphQL interface to package/task graphs        |
| Code generation         | `turbo generate`                                 | Scaffold new packages and components            |
| List packages           | `turbo ls`                                       | List all packages in monorepo                   |
| Devtools                | `turbo devtools`                                 | Visual Package Graph and Task Graph explorer    |
| Docker pruned workspace | `turbo prune <pkg> --docker`                     | Minimal monorepo slice for container builds     |

## Decision Trees

### Configure a Task

```text
Configure a task?
+-- Define task dependencies       -> dependsOn in turbo.json
+-- Lint/check-types (parallel)    -> Transit Nodes pattern
+-- Specify build outputs          -> outputs key
+-- Handle environment variables   -> env key or globalEnv
+-- Dev/watch tasks                -> persistent: true, cache: false
+-- Sidecar tasks (run alongside)  -> with key
+-- Package-specific config        -> Package turbo.json with extends: ["//"]
+-- Composable config              -> extends from any workspace package
+-- Global settings                -> globalEnv, globalDependencies, cacheDir
```

### Cache Problems

```text
Cache problems?
+-- Outputs not restored           -> Missing outputs key
+-- Unexpected cache misses        -> Use --summarize or --dry to debug
+-- Skip cache entirely            -> --force or cache: false
+-- Remote cache not working       -> Check turbo login/link
+-- Environment causing misses     -> Var not in env key
```

### Filter Packages

```text
Filter packages?
+-- By package name                -> --filter=web
+-- By directory                   -> --filter=./apps/*
+-- Package + dependencies         -> --filter=web...
+-- Package + dependents           -> --filter=...web
+-- Changed + dependents           -> --affected
```

### Explore Repository

```text
Explore repository?
+-- List all packages              -> turbo ls
+-- Query dependency graph         -> turbo query
+-- Visualize graphs               -> turbo devtools
+-- Check boundary violations      -> turbo boundaries
+-- Generate new package           -> turbo generate workspace
+-- Run custom generator           -> turbo generate run [name]
```

## Common Mistakes

| Mistake                                                                   | Correct Pattern                                                                                          |
| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Putting build logic in root `package.json` scripts instead of per-package | Define scripts in each package and use `turbo run` in root to delegate                                   |
| Using `^build` without declaring `workspace:*` dependency                 | Add the dependency in `package.json` first; `^build` only triggers for declared dependencies             |
| Chaining turbo tasks with `&&` in package scripts                         | Use `dependsOn` in `turbo.json` to declare task ordering                                                 |
| Not adding environment variables to the `env` key in turbo.json           | Declare all build-affecting env vars in `env` so cache hashes correctly                                  |
| Using `--parallel` flag to bypass dependency ordering                     | Configure `dependsOn` correctly or use transit nodes for parallel tasks with proper cache invalidation   |
| Using outdated schema URL                                                 | Use `https://turborepo.dev/schema.json` in `$schema` field                                               |
| Overriding inherited arrays in package configs                            | Use `$TURBO_EXTENDS$` in arrays to append instead of replace                                             |
| Defining tasks in root `turbo.json` that belong to a specific package     | Define tasks inside the package's own `turbo.json` with `extends: ["//"]`                                |
| Using `turbo <task>` shorthand in scripts or CI                           | Use `turbo run <task>` in `package.json` scripts and CI pipelines; shorthand is for interactive use only |

## Delegation

- **Monorepo structure exploration**: Use `Explore` agent to discover packages, workspace layout, and dependency relationships
- **Pipeline configuration and optimization**: Use `Task` agent to set up turbo.json tasks, configure caching, and debug cache misses
- **Monorepo architecture planning**: Use `Plan` agent to design package boundaries, shared libraries, and CI optimization strategy

> If the `pnpm-workspace` skill is available, delegate workspace setup, dependency linking, catalogs, and `pnpm deploy` to it.
> If the `changesets` skill is available, delegate versioning, changelog generation, and npm publishing to it.

## References

- [Task configuration and dependsOn patterns](references/task-configuration.md)
- [Caching, outputs, and debugging cache issues](references/caching.md)
- [Filtering, affected packages, and CI patterns](references/filtering-and-ci.md)
- [Workspace structure and package management](references/workspace-structure.md)
- [Environment variables and modes](references/environment-variables.md)
- [Watch mode, dev tasks, and anti-patterns](references/dev-and-anti-patterns.md)
- [Boundaries, query, and code generation](references/boundaries-and-tooling.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Каталог скиллов SKILL.md →

Сначала — turborepo от других авторов.

turborepo vercel Настраивает монорепозитории с Turborepo и чинит пайплайны задач. Пригодится при правках turbo.json, кеширования или сборки в CI. CX Codex +1 90 700установок turborepo Mindrally Задаёт агенту правила работы с Turborepo: структура воркспейсов, turbo.json, кэш и фильтры задач. Работает на существующем монорепо. CX Codex +1 704установок turborepo secondsky Направляет агента при настройке монорепозитория на Turborepo. Помогает составить пайплайны задач, настроить кеширование и избежать частых архитектурных ошибок. CX Codex +1 420установок turborepo-caching Seth Hobson Скилл turborepo-caching для Claude Code настраивает Turborepo для локального и удалённого кэширования сборок. Охватывает монорепозитории, CI/CD и поиск промахов кэша. CX Codex +1 10 600установок turborepo-monorepo giuseppe-trisciuoglio Скилл turborepo-monorepo ведёт агента по настройке Turborepo: workspace, задачи в turbo.json, тестовые пайплайны и кэш сборки. CX Codex +1 4 300установок find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Из того же набора106

Весь набор →
db-enforcer Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS. CX Codex +1 109установок electricsql Скилл для ИИ-кодинга по ElectricSQL: как стримить строки Postgres в клиент через Shapes, фильтровать их и не пускать запись мимо своего API. CX Codex +1 109установок trpc trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами. CX Codex +1 109установок tauri Помогает собирать приложения на Tauri v2 с веб-интерфейсом и бэкендом на Rust. Подключается при настройке проекта, IPC, разрешений или выпуска приложения. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок expert-instruction Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами. CX Codex +1 106установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой