school-advisor
Skill2 starsChanged 57 days agoMITView on GitHub
Use when asked anything about classes or the school week.
In this repository16 other files it gives its agents.
- canvas-course-syncSkill
- categorizerSkill
- course-knowledge-baseSkill
- course-study-sessionSkill
- email-draftingSkill
- exam-prepSkill
- grade-calculatorSkill
- homework-checklistSkill
- meetings-and-clubsSkill
- note-formatting-rulesSkill
- photos-to-pdfSkill
- roadmapSkill
- study-notes-workflowSkill
- suite-updateSkill
- verification-before-completionSkill
- writing-for-agentsSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
If asked something the brain can't answer from its index, refresh from sources once, answer, then note the gap to refresh in COURSE-BRAIN …
≈ “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
Config: resolve
<PLACEHOLDER>tokens from~/.hermes/school-config.md(seecanvas-course-sync→ School config). Never edit SKILL.md with real values.
School Advisor (front door)
Front-door router for the school suite. When the user asks anything class-related ("what's next", "catch me up", course questions, "remind me about..."), route instead of guessing:
- Course question → read that course's
COURSE-BRAIN.mdfirst (seecourse-knowledge-base). Only open source files (README/Notes/Materials/Announcements) if the brain doesn't answer. Never re-scan folders by default. - "What's my week / today / next" → answer from
Roadmap.md(load-tags 🟢/🟠/🔴, balanced by day, pre-shifts). Roadmap IS the calendar — assignments and study blocks live there, no .ics/Outlook (lateralized 9/14). - Stale or unknown data → trigger
canvas-course-syncsweep first, refresh COURSE-BRAINs, then answer. - Notes / studying →
study-notes-workflow(pipeline incl. Gemini comparison + mastery log) orcourse-study-sessionfor a session. - Homework photos →
photos-to-pdf→ stage submission PDF in Downloads. - Canvas-only platforms (Achieve/Pearson) → remind the user to self-check (they can't hold a pane login); log what they report.
- Dropped files / lost pile → the
categorizerskill (school-inbox mode): file the drop, or report the Lost pile waiting for descriptions.
Always
- Auto-log changes to Roadmap.md as they happen, no matter how small.
- Weekly digest (Sunday anchor): render the digest from
docs/weekly-digest-template.md— what changed, next-7-days from the Roadmap, weak spots from Mastery-Log, pending decisions (incl. Achieve/Pearson self-checks). It becomes the Sunday-review agenda; keep it conversational on top of the one file.
Pitfall
- If asked something the brain can't answer from its index, refresh from sources once, answer, then note the gap to refresh in COURSE-BRAIN refresh rules — never answer from stale memory.
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.

