GitHub Project ⇄ tasks.yml Reconciler

This skill is a pure reconciler. Every run computes the diff between a GitHub ProjectV2 board and a task-agent unified tasks.yml, applies the four sync rules, and exits. There is no "before run" / "after run" mode — the skill makes the two sides converge regardless of which direction state has drifted.

All real work — argument parsing, column resolution, yml IO, plan computation, and the gh calls that mutate the board — lives in scripts/gh_project_sync.py. This SKILL is a thin wrapper that runs the script's sync subcommand and relays its output. Use python3 …/gh_project_sync.py self-test to exercise the pure logic against in-memory fixtures (no gh calls, no network).

The four rules

For each (card, yml entry) pair, exactly one of these applies: