SKILL.md
Conductor Setup
Use this skill when configuring a repository for Conductor workspaces. When invoked directly, audit the setup against the conventions below and either apply the changes or report that none are needed.
Workflow
- Inspect
.conductor/settings.toml,.conductor/settings.local.toml, legacyconductor.json,.worktreeinclude,.conductor/.sh, legacy root-levelconductor-.sh, package scripts, and repo docs. CheckCONDUCTORISLOCALand decide whether each script supports local workspaces, cloud workspaces, or both. - Read only the references needed for the task:
- references/settings-and-migration.md for settings layers, schemas, supported repository fields, or conductor.json migration. - references/scripts-and-environment.md for setup/run/archive scripts, shells, variables, concurrency, Spotlight, or caches. - references/files-layouts-and-troubleshooting.md for Files to copy, .worktreeinclude, monorepos, linked repositories, MCP/privacy, or diagnosis. Read more than one only when the task crosses those concerns.
- Apply the selected reference's documented contract. Prefer team settings over machine-local configuration; preserve an existing deliberate script layout; use Conductor variables instead of hard-coded workspace paths, resources, and local ports.
- Keep secrets and machine-specific credentials out of committed settings. Change MCP/privacy configuration only when asked or required by repository policy.
- Validate TOML and run the narrowest relevant check for every script changed. Report when the existing setup already satisfies the requested outcome.
Resources
references/settings-and-migration.md: settings scope, precedence, fields, schemas, and legacy migration.references/scripts-and-environment.md: script roles, local/cloud shells and variables, run behavior, caches, and cleanup.references/files-layouts-and-troubleshooting.md: copied files, repository layouts, privacy boundaries, and diagnosis.