agenda-sync
Skill0 starsChanged 5 months agoMITView on GitHub
Cross-check your calendar against your todos to surface gaps. Deadlines with no time blocked to do them, overdue/at-risk todos, and appointments that have no prep todo. Use to reconcile your plan, catch what is about to slip, or run a weekly review.
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 11
Anchor to now: Run date "+%A %Y-%m-%d %H:%M %Z".
- Very specific: line 23
Add a prep/buffer todo: todos/scripts/add.sh "<list>" "<prep task>" YYYY-MM-DD <priority>.
- Distinctive: line 24
Add a due date to a dateless-but-deadlined todo (back-calculated, never fabricated.
- Distinctive: line 31
Read-only until you approve a write.
- Distinctive: line 32
Never fabricate a due date or a meeting time.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Agenda Sync (calendar ↔ todos reconciliation)
Reconciles two sources you already have: Apple Reminders ([[todos]]) and Apple Calendar ([[calendar]]). The point is to catch the gaps between intention (todos) and schedule (calendar). Analysis is read-only; it only writes (blocks / prep todos) after you approve. Mac-only. Requires the [[calendar]] and [[todos]] skills installed alongside it.
On invocation
- Anchor to now. Run
date "+%A %Y-%m-%d %H:%M %Z". All "overdue / imminent" judgments key off this. - Pull both sources:
- Todos:
bash ~/.claude/skills/todos/scripts/list.sh(slow, 30 to 60s; lines areLIST ||| TITLE ||| DUE ||| PRIORITY). - Calendar:
bash ~/.claude/skills/calendar/scripts/list.sh 14(today to +14 days; widen for far-off deadlines).
- Todos:
- Compute the gaps, which is the whole point:
- 🔴 Deadline, no block: a todo with a due date but no calendar time set aside to actually do it before then (e.g. a deliverable due Thursday 3pm with nothing blocked to prepare it). The nearer the due date and the bigger the task, the louder the flag.
- ⏰ Overdue / at-risk: due date already passed, or imminent with no progress block. Surface long-lead items (anything with a notice period or external dependency) early.
- 📋 Event, no prep: a meeting/appointment that clearly needs preparation but has no matching prep todo (advisor/manager 1:1s, presentations, admin or medical appointments).
- 🧭 Lead-time mismatch: a deadline whose external lead time (notice periods, shipping, doc-gathering) is longer than the time remaining.
- Present a short reconciliation, grouped by the four buckets above. Each line names the specific todo/event and the concrete fix. Do not restate the full calendar or todo list; only the gaps.
- Offer the fixes, act on approval:
- Block time for a deadline:
calendar/scripts/add.sh "" "<task> prep" "YYYY-MM-DD HH:MM" <min>. - Add a prep/buffer todo:
todos/scripts/add.sh "<list>" "<prep task>" YYYY-MM-DD <priority>. - Add a due date to a dateless-but-deadlined todo (back-calculated, never fabricated; confirm the real deadline first). Confirm before bulk changes; one or two obvious fixes can be proposed and applied on a "yes".
- Block time for a deadline:
Good cadence
Works well as a weekly review (e.g. Friday, alongside a next-week calendar preview) or any time the plan feels out of sync. Can be looped: /loop /agenda-sync (self-paced), but it is most useful on demand, not on a tight timer.
Guardrails
- Read-only until you approve a write. Never silently add or move things.
- Never fabricate a due date or a meeting time; ask for the real deadline.
- Mailing-list / recurring social events do not need prep todos; do not flag them.
- The todos
list.shis slow and may background: read its output when it completes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

