| name | onboard-project |
| description | Wire a new project — writes maestro.json and scaffolds the temp directory structure. |
Onboard Project
Wires a WordPress plugin project into the Maestro ecosystem in one pass: writes
.claude/maestro.json, scaffolds the .ai/ working directory, and prints
the next steps. After this skill runs, the project is ready for every Maestro
agent and workflow. Podium (the optional dashboard) can be installed separately.
Run from the project root (the plugin repo), not from inside Maestro.
Note: Podium is now optional (Step 5 update)
In earlier versions, Podium hooks were installed as part of onboarding. Podium
is now a separate plugin (see Installation section). Step 5 has been
simplified.
Step 1 — Guard
ls .claude/maestro.json 2>/dev/null
If .claude/maestro.json already exists, show its contents and ask:
.claude/maestro.json already exists. Overwrite it, or update only
missing/null fields?
Stop until the user responds. Do not clobber an existing config silently.
Step 2 — Gather project details
Collect these five values. Infer sensible defaults from the git remote and
directory structure first, then confirm with the user — do not invent values
you can't verify.
git remote get-url origin 2>/dev/null
basename "$(pwd)"
ls -la
ls *.php 2>/dev/null