| name | tune-cadence |
| description | Query or change how often this repo's autonomous GitHub Actions run (pull-card, audit-deck, refine-deck). AUTO-INVOKE when the user asks what the current cadence is, how often pull-card/audit/refine run, to speed up or slow down the deck, to run pull-card every N hours, to change the autonomous cadence, or to retune the workflows. Repo-local dev skill that wraps scripts/set_cadence.py; not a packaged goc skill. |
Tune the autonomous workflow cadence
This repo drives three autonomous agents from GitHub Actions:
- pull-card (
.github/workflows/pull-card.yml) — drains the queue.
- audit-deck (
.github/workflows/audit-deck.yml) — files one new card per run.
- refine-deck (
.github/workflows/refine-deck.yml) — one deck-hygiene pass per run.
Their schedules are GitHub Actions cron: literals, which can't read a
config file. scripts/set_cadence.py rewrites those literals (and the
managed # cadence: comment beside each) from a small interval spec, so
this skill is just a thin wrapper around it.
Query the current cadence
python3 scripts/set_cadence.py --show
Prints each workflow's cron plus its human-readable interval.
Change the cadence
python3 scripts/set_cadence.py --pull 1h --audit 3h --refine 3h
- Pass only the workflows you want to change; omit the rest to leave them.
- Interval specs:
<N>h where N divides 24 (1, 2, 3, 4, 6, 8, 12) or
24h; <N>d for every-N-days; and 1w for exact weekly. Note Nd
(N≥2) becomes a day-of-month */N cron step that realigns each month,
so it's "roughly every N days" — the gap across a month boundary is
shorter. 1w is exact (day-of-week, every Monday); there is no clean
cron for every-N-days or every-N-weeks.
- An optional
+P hour-phase suffix shifts a schedule by whole hours —
use it to keep two workflows on the same interval a full hour apart
(the minute offsets below only separate them within an hour slot).
3h+1 fires at 01:xx, 04:xx, … instead of 00:xx, 03:xx, …. For Nh
(N≥2) the phase must be < N; for 24h/Nd/1w it sets the
hour-of-day (0–23); 1h takes no phase.
- Minute offsets are fixed (pull
:13, audit :15, refine :45) so the
three deck-mutating agents never launch on the same minute and race on
main.
Make it take effect
Scheduled workflows run from the default branch, so a cadence change
does nothing until it is committed and pushed to main:
git add .github/workflows/pull-card.yml \
.github/workflows/audit-deck.yml \
.github/workflows/refine-deck.yml
git commit -m "ci: retune autonomous cadence"
git push
Follow AGENTS.md "Parallel-Agent Commit Safety" — stage explicit paths,
verify git diff --cached, commit with a pathspec.
Cost note
Each run of any of these workflows is a full Opus agent under
bypassPermissions. Faster cadence means more token spend; dial it back
toward daily when spare-token headroom is tight. The cap on pull-card's
per-tick self-trigger chain is separate — it lives in MAX_ITERATIONS
inside pull-card.yml, not here.
