github-ci-watch — react when CI breaks
An opt-in poller skill that ships with mimir under
mimir/optional-skills/ but is NOT auto-installed — most installs
don't watch a repo's CI, so the framework doesn't seed it by default.
It watches the main branch of each GITHUB_REPOS entry, inspects
the last few GitHub Actions workflow runs, and emits one ci_failure
event per newly-failed run (conclusion failure / timed_out /
startup_failure). Green builds produce zero output — the
"silence as filter" principle: this poller only speaks when CI breaks.
Installation
Copy the directory into your agent home:
cp -r mimir/optional-skills/github-ci-watch <home>/skills/(Or run from inside the container against
/workspace/mimir.)Set the env vars — at minimum
GITHUB_REPOS(plusGITHUB_TOKENifgh authisn't already configured in the environment).The
pollersframework discoverspollers.jsonand runsscripts/poller.pyon its cron (default*/15 * * * *).
State
Reported run IDs are tracked in seen_run_ids.json (trimmed to the
last 200) so a given failure is reported exactly once. State lives in
$STATE_DIR (resolved by the framework to a persistent per-poller
location that survives container rebuilds).
Output
One JSONL event per new failure:
{event_type: "ci_failure", repo, branch, workflow, conclusion, run_id, created_at, url, prompt} — the prompt is the turn the
agent wakes on.