Turborepo — скилл
Скилл Vercel для монорепозиториев на Turborepo: настройка turbo.json, кеш, фильтры и CI по документации, которая лежит в установленном пакете
- 31 232 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Сам скилл содержит только инструкции: он ничего не запускает и направляет агента в документацию
- Команды turbo run, которые агент выполнит по подсказкам, запускают скрипты вашего проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/turborepoОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сам скилл содержит только инструкции: он ничего не запускает и направляет агента в документацию
- Команды turbo run, которые агент выполнит по подсказкам, запускают скрипты вашего проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл учит агента настраивать и чинить репозитории на Turborepo, не полагаясь на устаревшие знания модели. Он срабатывает на запросах про turbo.json, конвейеры задач, кеш и Remote Cache, фильтры, переменные окружения, границы пакетов, структуру монорепозитория и CI. Сам SKILL.md короткий и отправляет агента в документацию, которая поставляется внутри пакета turbo и совпадает с установленной версией. Отправная точка — файл node_modules/turbo/docs/README.md с указателем задач: по нему агент выбирает самую узкую нужную страницу. Если пакет лежит не в корне `node_modules`, место находит команда node -p "require.resolve('turbo/package.json')". Если turbo еще не установлен, агент сначала смотрит менеджер пакетов и ограничения версий, затем ставит пакет и читает его документацию. По описанию в документации Turborepo, скилл дает рекомендации по конфигурации, шаблоны монорепозиториев, антипаттерны и приемы ускорения.
Для кого. Для разработчиков JavaScript и TypeScript, которые ведут монорепозиторий на Turborepo и просят агента поправить конвейер задач, кеш или CI.
Подходит, если
- В turbo.json нужно добавить задачу с зависимостью от сборки соседних пакетов и правильными outputs
- Сборка в CI медленная, и агенту надо подобрать фильтры и настроить Remote Cache
- Переменные окружения попадают в хеш задач неожиданным образом, и нужно разобраться, почему кеш не срабатывает
- Из одного пакета растет второй, и нужно навести порядок в границах пакетов и структуре монорепозитория
- Версия turbo в проекте старше обычных примеров, и агенту нужны документы под ее версию
Не подходит, если
- Проект не использует Turborepo: для Nx, Lerna или других сборщиков скилл ничего не знает
- Нужны советы по конкретному фреймворку: SKILL.md прямо говорит не опираться на него в вопросах фреймворков
- Нужен разовый ответ без установки turbo: документы берутся из пакета, а без него скилл только подскажет, как его поставить
Пример запроса к агенту
Добавь в turbo.json задачу test, которая запускается после build зависимых пакетов, и настрой кеш так, чтобы он не ломался от переменных окружения CIОграничения
Скилл содержит только указатель на документацию, поэтому ценность зависит от установленной версии turbo: документы читаются из `node_modules`. Для Remote Cache нужен отдельный аккаунт сервиса кеширования. Установка командой npx skills add не указана в README репозитория, ее приводит страница документации про работу с ИИ. Скилл обновляется вместе с репозиторием, а документы всегда берутся из той версии turbo, которая стоит в проекте. Если в монорепозитории несколько приложений с разными версиями turbo, агенту нужно сначала определить, с каким пакетом он работает.
Как отключить. Удалите папку turborepo из каталога скиллов агента, например командой npx skills remove turborepo. Управляемый блок в AGENTS.md, если он появился, удаляется вручную: параметр agentGuidance в turbo.json его не стирает.
Частые вопросы
Как поставить скилл Turborepo в Claude Code?
Выполните npx skills add vercel/turborepo. Так предлагает документация Turborepo в разделе про работу с ИИ, а установщик спросит, для каких агентов поставить скилл.
Откуда скилл берет знания о Turborepo?
Из документации внутри пакета turbo, без обращения к интернету. Страницы лежат в node_modules/turbo/docs, совпадают с установленной версией и работают без сети, поэтому агент не подставляет настройки другого релиза.
Что делает параметр agentGuidance в turbo.json?
При значении true команда turbo, заметив ИИ-агента, ведет в AGENTS.md в корне репозитория отдельный помеченный блок. Блок отправляет агента к документации установленного пакета и не затрагивает остальные инструкции файла. Изменения блока стоит коммитить вместе с работой.
Как искать по документации из терминала?
Командой turbo docs с текстом запроса, например turbo docs "package configurations". Она выводит ссылки на страницы под вашу версию turbo.
Можно ли запускать несколько агентов на одном репозитории?
Да, через git worktree: у каждого агента свой каталог при общей истории. Turborepo делит локальный кеш между рабочими деревьями, поэтому второй агент получает попадание в кеш после сборки первого. С Remote Cache этот эффект работает и между машинами.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыprek — скилл для агентов
prek skill
Скилл prek учит агента настраивать Git-хуки на prek, Rust-замене pre-commit: конфиг, шимы, приоритеты, встроенные хуки и монорепозитории
Скилл KubeShark: агент сначала ищет режим отказа, потом пишет манифесты, Helm и Kustomize по официальным практикам и возвращает план проверки и отката
Официальный набор скиллов Grafana: PromQL, Loki, Tempo, Alloy, k6, дашборды и алертинг для Claude Code, Cursor и Codex
31 скилл для DevOps в Claude Code и Codex: генераторы конфигов, валидаторы и отладчик Kubernetes для Terraform, Helm, CI и Docker
Скилл для Terraform в Claude Code, Codex, Antigravity и Gemini CLI: убирает галлюцинации и держит код на официальных практиках HashiCorp
Официальный набор скиллов Cloudflare для агентов: Workers, Durable Objects, wrangler, Pages, хранилища и MCP-сервер
Коротко о README
README репозитория короткий: Turborepo назван системой сборки для кодирующих агентов, адрес для старта указан на сайте проекта. Дальше идут ссылки на вклад в проект, сообщество и политику безопасности. Рекомендации для агентов вынесены на страницу документации про ИИ и в сам SKILL.md.
Бейдж для README
Исходный SKILL.md
---
name: turborepo
description: Configure and troubleshoot Turborepo repositories. Use when working with turbo.json, task pipelines, caching, Remote Cache, the turbo CLI, filtering, environment variables, package boundaries, monorepo structure, or CI workflows.
---
# Turborepo
The complete Turborepo documentation ships inside the installed `turbo` package. Do not rely on this skill for framework guidance. Always read the bundled docs, which match the installed version exactly.
Start with:
```text
node_modules/turbo/docs/README.md
```
Use that task index to choose the smallest relevant documentation page. Read it before changing Turborepo configuration, package scripts, or CI workflows.
If the package manager uses a non-flat `node_modules` layout or a workspace link, resolve the package location first:
```sh
node -p "require.resolve('turbo/package.json')"
```
Then read `docs/README.md` relative to the resolved package directory.
If `turbo` is not installed, inspect the repository's package manager and existing version constraints before adding it. After installation, use the bundled docs rather than guidance for a different release.