| name | set-me-up |
| description | Repo-local onboarding for this lab-agent-config repository. Auto-trigger inside this repository when the user asks to set up, initialize, install, onboard, configure, or get started with this repository or its Codex configuration. |
Set Me Up
Guide the user through first-run setup for this repository. This is a repo-local onboarding skill, not a symlinked content skill for downstream projects.
Use the exact onboarding script in references/onboarding-script.md. The script is mandatory: do not summarize it, reorder it, skip consent checkpoints, or install recommended skills by default.
Core rules:
- Auto-trigger this skill when the user asks to set up, initialize, install, onboard, configure, or get started with this repository or its Codex configuration. The user does not need to invoke
$set-me-up.
- Use this skill only when the active working directory is this repository or a subdirectory of it. Do not use this skill for downstream project setup; use
init-project for downstream projects.
- Onboard before installing. Explain what the repo contains before creating global files or symlinks.
- Ask before every installation step. Do not run
install --agent codex until the user explicitly agrees to base setup. Do not link any optional skill until the user explicitly chooses it.
- Treat recommendations as explanations, not consent.
- Tell the user that skipped skills can still be installed project-locally later.
- If the user asks for a faster path, still state exactly what will be installed and ask for one explicit confirmation before installing anything.
Workflow
- Read
README.md and references/onboarding-script.md.
- Confirm the current directory is this config repo.
pwd
test -x bin/config-agent-tool && test -d codex/skills && test -f codex/global/AGENTS.md && echo config-repo
- Follow the script. The first user-facing message must welcome the user, summarize the three README features, and explain that setup is a guided choice process.
- Only after the user consents, run
bin/config-agent-tool install --agent codex. If setup fails because ~/.codex/AGENTS.override.md already exists and was not generated by this repo, stop and explain that setup refused to overwrite the user's active global instruction file. Ask whether they want to move that file's content into ~/.codex/user/AGENTS.md, back it up, or intentionally overwrite it by running ${CODEX_HOME:-$HOME/.codex}/bin/config-agent-tool render-override --agent codex without --first-run. If setup fails because ~/.codex/hooks.json already exists and is not managed by this repo, explain that setup refused to overwrite the user's hook configuration after installing the other managed surfaces. Ask whether they want you to manually merge this repo's SessionStart startup hook into that file, then rerun bin/config-agent-tool install --agent codex. If setup fails because ~/.codex/hooks/ already exists and is not managed by this repo, explain that setup refused to overwrite the user's hook scripts and ask whether they want you to merge or move the existing scripts before rerunning install.
- For subsequent setup commands, use the installed tool path:
${CODEX_HOME:-$HOME/.codex}/bin/config-agent-tool.
- Run
${CODEX_HOME:-$HOME/.codex}/bin/config-agent-tool list-skills --agent codex --global and continue the scripted skill walkthrough.
- After collecting explicit choices, run:
${CODEX_HOME:-$HOME/.codex}/bin/config-agent-tool link-skills --agent codex --global --add <chosen-skill-names>
Skip this command if the user chooses no global skills.
8. Verify the files and symlinks created by setup:
~/.codex/user/AGENTS.md~/.codex/AGENTS.override.md~/.codex/bin/config-agent-tool~/.codex/hooks.json~/.codex/hooks/update-config.sh- any chosen global skills under
~/.codex/skills/
- Finish with the scripted closing: restart Codex, review/trust the startup hook with
/hooks if Codex asks, use render-override after edits, and run init project inside other repositories.
Do not use this skill for project onboarding outside this repository. Do not touch remotes, publishing settings, or GitHub visibility unless explicitly asked.
