/yolo-init
Use when setting up YOLO in a repo for the first time, or repairing the setup. Creates workspace/features/ and workspace/config.yaml. Triggers on "set up YOLO here", "init yolo", "yolo init".
Claude Code
$ npx -y skills add CoriChui/yolo --skill yolo-init --agent claude-code
Codex
$ npx skills add CoriChui/yolo --skill yolo-init -a codex -y
Cursor
$ npx skills add CoriChui/yolo --skill yolo-init -a cursor -y
Gemini CLI
$ npx skills add CoriChui/yolo --skill yolo-init -a gemini-cli -y
GitHub Copilot
$ npx skills add CoriChui/yolo --skill yolo-init -a github-copilot -y
OpenCode
$ npx skills add CoriChui/yolo --skill yolo-init -a opencode -y
Windsurf
$ npx skills add CoriChui/yolo --skill yolo-init -a windsurf -y
SKILL.md
yolo-init.SKILL.mdname: yolo-init description: Use when setting up YOLO in a repo for the first time, or repairing the setup. Creates workspace/features/ and workspace/config.yaml. Triggers on "set up YOLO here", "init yolo", "yolo init".
yolo-init
Make a repo YOLO-ready. Idempotent: safe to re-run as a repair. Rules: `../../yolo/conventions.md`.
Procedure
1. Create `workspace/features/` if missing, with a `.gitkeep`. 2. If `workspace/config.yaml` is missing, copy `../../yolo/templates/config.yaml` there. Set `project.name` to the repo directory name and `project.base_branch` with the detection rule (conventions *base_branch*). If it exists, only fill missing keys; never overwrite a value the user set. 3. Commit (`yolo: init`).
Upgrading from older YOLO
Older versions also created `workspace/decisions/`, `workspace/debug/`, task trailers and a routing block in the project's agent instructions file. Leave existing files alone; they are history. If the user wants the routing block gone, remove the text between the `YOLO:routing-block start` and `end` markers.
Constraints
- Never git-ignore `workspace/`. It has to survive branches and worktrees.
- Writes only project state: `workspace/` and its config.
A thin state layer for agent-driven feature work. A feature is a short brief plus a git branch, and its status is derived from git every time you ask. Nothing is stored, so nothing drifts. YOLO doesn't tell your agent how to plan, build or review.
Other skills on yolo.
More skills from other plugins.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
ask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
Questions about yolo-init.
- Which coding agents can use yolo-init?
- yolo-init installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.

