trigger-setup — Claude Code skill: what it does, how to install
Bootstraps Trigger.dev in an existing codebase, installs runtime and build packages, and configures your initial background task.
npx skills add triggerdotdev/skills --skill trigger-setup -a claude-codeWhat trigger-setup does
The skill handles Trigger.dev project initialization from scratch. It runs the setup wizard or executes manual steps when working within monorepos and non-interactive environments. The workflow installs @trigger.dev/sdk as a runtime dependency alongside @trigger.dev/build for development. Then it generates trigger.config.ts, includes it in tsconfig.json, and adds .trigger to .gitignore.
Headless sessions cannot complete login automatically. The skill triggers a resumable authentication flow, prints the authorization link, and waits for your confirmation. Version alignment is critical here: running CLI tools on a different release than the SDK will cause runtime warnings or build failures during dev and deploy steps.
What it helps with
- Initialize Trigger.dev inside an existing project
- Create
trigger.config.tswith correct directories and project references - Scaffold the first task with a unique identifier
- Handle CLI authentication in headless terminal environments
Example prompts for the agent
- Set up Trigger.dev in this project and generate a sample task
- Configure Trigger.dev manually for our monorepo
- Run the Trigger.dev development server and wire environment keys
How to install trigger-setup
1Skills CLI (Vercel)
npx skills add triggerdotdev/skills --skill trigger-setup -a claude-code2Manually: put the files in place
~/.claude/skills/trigger-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/trigger-setup/
1Skills CLI (Vercel)
npx skills add triggerdotdev/skills --skill trigger-setup -a codex2Manually: put the files in place
.agents/skills/trigger-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add triggerdotdev/skills --skill trigger-setup -a cursor2Manually: put the files in place
.cursor/skills/trigger-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install triggerdotdev/skills trigger-setup2Manually: put the files in place
.github/skills/trigger-setup/SKILL.md1Skills CLI (Vercel)
npx skills add triggerdotdev/skills --skill trigger-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/triggerdotdev/skills --path trigger-setupManually: put the files in place
.devin/skills/trigger-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add triggerdotdev/skills --skill trigger-setup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about trigger-setup
How to install trigger-setup in Claude Code?
Run npx skills add triggerdotdev/skills --skill trigger-setup -a claude-code. The skill file will be placed at ~/.claude/skills/trigger-setup/SKILL.md.
What does trigger-setup do?
It scaffolds Trigger.dev configuration files, installs the SDK and build packages, registers tasks, and sets up project ignore lists.
How does CLI authentication work in automated sessions?
The skill executes login with --no-browser and --no-wait parameters to generate an authorization URL. You verify the login in your browser, after which the CLI resumes session tokens.
