turborepo · vercel — Claude Code skill: what it does, how to install
Configures Turborepo monorepos and troubleshoots task pipelines. Useful when editing turbo.json, setting up caching, or fixing CI builds.
npx skills add vercel/turborepo --skill turborepo -a claude-codeWhat turborepo does
This skill guides agents through Turborepo setup, task pipelines, and caching strategies like Remote Cache. It covers filtering, environment variables, monorepo boundaries, and CI workflows.
The skill does not ship static guidance. Instead, it instructs the agent to read node_modules/turbo/docs/README.md directly from the project. For non-flat dependency trees, it resolves the package directory with node -p "require.resolve('turbo/package.json')". This keeps suggestions aligned with the installed release.
Install this if your repository uses or plans to adopt turbo. In projects without a monorepo setup, it has no practical use.
What it helps with
- Configure task pipelines and caching in turbo.json
- Troubleshoot Remote Cache and environment variables
- Organize package boundaries and filtering in a monorepo
- Align CI workflows with the installed turbo documentation
Example prompts for the agent
- Review our turbo.json pipeline and check Remote Cache settings
- Why is the build task ignoring the cache for this package?
- Help set up task filtering for our pull request CI workflow
How to install turborepo
1Skills CLI (Vercel)
npx skills add vercel/turborepo --skill turborepo -a claude-code2Manually: put the files in place
~/.claude/skills/turborepo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/turborepo/
1Skills CLI (Vercel)
npx skills add vercel/turborepo --skill turborepo -a codex2Manually: put the files in place
.agents/skills/turborepo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vercel/turborepo --skill turborepo -a cursor2Manually: put the files in place
.cursor/skills/turborepo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vercel/turborepo turborepo2Manually: put the files in place
.github/skills/turborepo/SKILL.md1Skills CLI (Vercel)
npx skills add vercel/turborepo --skill turborepo -a gemini-cli2Platform CLI
gemini skills install https://github.com/vercel/turborepo --path skills/turborepoManually: put the files in place
.devin/skills/turborepo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vercel/turborepo --skill turborepo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Other versions of turborepo
Similar
Questions about turborepo
How do I install turborepo in Claude Code?
Run npx skills add vercel/turborepo --skill turborepo -a claude-code in your terminal.
What does the turborepo skill do?
It guides the agent when configuring turbo.json, task pipelines, caching, and CI workflows in Turborepo projects.
Where does the skill get documentation from?
It reads the docs/README.md file bundled inside the locally installed turbo package so instructions match your specific version.
Source text
SKILL.md · MIT
---
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.
© vercel · MIT · vercel/turborepo
