arc-skill

---
name: arc-skill
description: Solve an interactive hidden-rule ARC-AGI-3 game from its game ID. Contains the complete playing doctrine (predict before every action, graded claims, one-page notes, optional executable-rules search) plus the `arc` harness the agent drives. Use whenever asked to solve, play, or continue an ARC-AGI-3 game.
---

# Arc skill

Set the launcher once, work inside one directory per game, then start or resume:

```bash
ARC="<this-skill-directory>/scripts/arc"   # absolute path
mkdir -p <run-dir> && cd <run-dir>         # one directory = one run
"$ARC" start <GAME_ID>
```

`start` defaults to a local simulator with competition semantics: one logical
run, append-only history, paid resets, completed levels never lost. It is
crash-safe — after any interruption, rerun `"$ARC" start <GAME_ID>` and the run
is resumed or replayed exactly. Use `--mode competition` (live remote server,
~15-minute idle lease, no replay recovery) only when the user explicitly asks.
Never create a second run for the same game, never inspect the game's source or
private state, and never edit `.arc/` by hand except `NOTES.md`.

## The game

A 64×64 board of 16 colors, hidden rules, several levels. Interface priors
(not guarantees): ACTION1/2/3/4 = up/down/left/right, ACTION5 = interact,
ACTION6:x,y = click at x=column y=row, ACTION7 = undo. Availability can change
after every action.

**Finish first.** Historically every lost point came from unfinished games, not
from extra actions. Early levels are usually cheap tutorials: a wrong action
that teaches a mechanic beats a minute of deliberation. Act early, act often,
learn from every grade. Efficiency only matters once finishing is likely.

## The loop — look, predict, act, compare, note

1. **Look**: open the printed `IMAGE`; read the worded `TRANSITION` story.
2. **Predict + act**: every action requires `--predict`; the harness grades it:

```bash
"$ARC" act ACTION1 --predict "move 12,5 0,-1"
"$ARC" act ACTION6 3 14 --predict "cell 3,14=9; region 0:8,10:20" --because "test button"
```