usyd-admin-sync

Synchronize and validate USYD admin data across logs, Canvas, timetable, and Notion.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ringlochid/Homura-WorkSpace --skill usyd-admin-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usyd-admin-sync
Source: https://github.com/ringlochid/Homura-WorkSpace/tree/main/skills/usyd-admin-sync
Command: npx skills add https://github.com/ringlochid/Homura-WorkSpace --skill usyd-admin-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps teams coordinate and verify the USYD admin automation stack by aligning local logs, Notion snapshots, Canvas data, and the timetable, reducing manual checks and drift.

Core Features & Use Cases

  • Inspect current state: review downloads/usyd/sync.log, downloads/usyd/latest_snapshot.json, and the current Notion page titled USYD Admin Snapshot to determine if updates are needed.
  • Verify source truth: compare Canvas assignments, quizzes, and due dates with the timetable CSV to ensure consistency before publishing tasks or updates.
  • Run and maintain: execute local scripts to refresh the latest snapshot, append to the sync log, and upsert Notion pages and student tasks, while archiving stale entries when appropriate.
  • Scheduling & reliability: daily runs are guarded by a user-level systemd timer and flock lock to prevent overlapping executions.

Quick Start

Run the local USYD admin sync to refresh the latest snapshot and update Notion pages.

Frequently Asked Questions about usyd-admin-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate syncing university admin data from Canvas to Notion?

To automate university admin data sync, this Skill executes local scripts to upsert Notion pages and student tasks by comparing Canvas assignments and timetable CSVs, refreshing latest_snapshot.json, and appending to sync.log.

How do I verify Canvas assignments and timetable data before publishing to Notion?

To verify Canvas and timetable data, this Skill enforces source truth precedence by comparing Canvas assignments, quizzes, and due dates against the timetable CSV to ensure consistency before upserting Notion pages.

What's the best way to check if the daily university admin sync ran successfully?

Checking the daily sync status involves reviewing downloads/usyd/sync.log, latest_snapshot.json, and the Notion USYD Admin Snapshot page to determine if updates are needed or if the daily run executed correctly.

Can I use a systemd timer and flock lock to prevent overlapping university admin sync runs?

Yes, daily university admin sync runs are guarded by a user-level systemd timer and flock lock to prevent overlapping executions, ensuring reliable scheduling and sequential script processing.

How do I archive stale student tasks and Notion pages during the admin sync process?

Archiving stale entries during the admin sync process is handled by local scripts that upsert current Notion pages and student tasks while identifying and archiving outdated entries based on the latest snapshot data.

Why does my university admin data drift between local logs and Notion snapshots?

University admin data drift between local logs and Notion occurs when sync processes are skipped; this Skill aligns local logs, Notion snapshots, Canvas data, and the timetable to reduce manual checks and prevent inconsistency.