Set up this project's Agent Teams game and lead in its orca.yaml by asking the person what they want to integrate (tracker To Do, buttons, MCP activity links, the lead and its rules, scene), reading the repo for what it already uses, and writing only what they confirm. Fire when the person runs /orca-game:setup, or says "configura el juego", "configura orca.yaml", "integra Jira / Tambora / Plane en el juego", "set up the game", "add a button to the game".
Recursos
1Instal·la
npx skillscat add ab2webco/orca-oss/setup Instal·la des del registre de SkillsCat.
/setup — write this project's orca.yaml with the person
Talk in the person's language. Ask one question at a time (AskUserQuestion when available,
with the detected option first), and never write a value they did not confirm.CLI below is "$ORCA_GAME_CLI", the absolute path Orca sets in its game panes. If it is empty,
say this session was not started by Orca's game and stop; never run a bare orca (on Linux it is
usually the GNOME screen reader).
1. Read what is there
CLI game state --json: the effectiveconfig, which layer set each key (sources), thelead, theactions, theprojectTo Do and PRs, andwarnings.- The repo root's
orca.yaml, if any. Keep every key and comment it already has. - What the project already uses, so you can offer it instead of asking blind:
CLAUDE.md/AGENTS.md: flow rules (repo per ticket, review gates, no deploys, who merges).- Git remotes and sibling repos the work spans (a frontend and a backend, say).
- Tracker: ticket keys in branches and commits (
CIN-123Jira,ORCA-12Plane,ENG-4Linear),jira/plane/linearCLIs, their MCP servers. - MCP servers (
.mcp.json, Claude settings) whose ids could become links (test runs, builds). bin/and package scripts the person runs by hand (tests, cleanups, reports).
Say in three to six lines what you found, then ask.
2. Ask what to integrate
Offer only what applies, in this order, and skip what they decline:
- To Do (
todo): which tracker and project, and whether its link should run an action
instead of opening the tracker's page (todo.action). - Buttons (
actions, at most 6): what they repeat by hand. For each, a label, a slash
command, and either a prompt for the lead or an MCP call. A prompt says what to run and what to
report; work that is not the lead's goes to members (game launch <id> --prompt "…"). - Activity links (
activity): an MCP tool whose ids should become chips (test runs, builds).
Ask for one real id and its page URL, and derivematchandurlfrom them. - The lead (
orchestrator): name, autostart, members at once (cap), agent and model, what a
member is told (launchPrompt), and the project rules from step 1 the lead must follow
(rules). The lead never does ticket work itself. - Look: scene, HUD, rewards,
render(classic5-row pixel art,hd9 to 14-row scene orhd-compact7-row hd scene)
and, for hd's day and night,timezone(localor the team's IANA zone, e.g.America/Bogota).
3. Write and check
- Show the YAML you will add or change, then write it after the person says yes. Edit in place;
never drop their keys or comments. - The exact keys and limits are in reference.md. Run
CLI game state --jsonagain
(Orca re-reads orca.yaml on each refresh) and fix everywarningsentry until there are none. - Never put a token, password or private URL credential in orca.yaml: it is committed. A scene
file the person marks as private stays out of git. - Finish with what changed, the buttons and their slash commands, and that ↻ in the Panel shows it.