oguzdogmus/mimir / skills/mimir-setup
mimir-setup
VerifiedOne-time full Mimir setup. Picks the learning folder, the course and teaching languages, any exam dates already known, and optionally a starting teaching style.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
| references/sampler.md | markdown | 3.2 KB |
SKILL.md
View on GitHub---
name: mimir-setup
description: One-time full Mimir setup. Picks the learning folder, the course and teaching languages, any exam dates already known, and optionally a starting teaching style.
disable-model-invocation: true
---
First read `../mimir-core-rules/SKILL.md` (beside this skill's folder) unless it is already loaded; it defines `<mimir>`.
Reads at start: `workspace.py root` output. Nothing else; `references/sampler.md` is read only in step 6, when the sampler runs.
All workspace changes go through `python3 "<mimir>/scripts/workspace.py" <cmd>`. Pass its JSON on stdin with a quoted heredoc (`<<'EOF'`) so paths with spaces survive. It prints one JSON object with a ready-to-print `line`.
1. Run `root` with `{}`. If `setup_done` is set, say "Setup already done on <setup_done>. Your learning folder is <root>." and stop.
2. Say: "One-time setup. This may take a few minutes, and it will not be repeated."
3. Ask everything in one numbered message, then wait for one reply:
1. Learning folder: currently `<root>`. Keep it, or give another path?
2. Which language are your courses and exams in, and which language do you want explanations in?
3. Exams you already know, each with its date and time and what it covers (course code, exam, date, time, what it covers; "Don't know" is fine for the time and for what it covers), or "none".
For anything left unanswered, pick a default and declare it: keep the folder; teaching language = the language the student writes in; course language = the teaching language; no exam dates.
4. Apply the folder choice:
- Kept: `init` with `{}`.
- New path and `exists` was true: `relocate` with `{"to": "<path>"}`.
- New path and `exists` was false: `init` with `{"root": "<path>"}`.
- If relocate is refused, keep the current folder, run `init` with `{}`, and declare it.
Print each returned `line`. If any other `init` or `relocate` call exits non-zero, show its stderr line and stop without editing the profile.
5. Edit `.state/profile.md` under the `root` from the last returned JSON, keeping the template's shape:
- `course_language:` and `teaching_language:`.
- First run `python3 "<mimir>/scripts/session.py" now` with `{}` on stdin once: `N` is its `now`.
- One `| CODE | exam | <exam> |` row per known exam under `## Exam dates`, `<exam>` being its `exam` from `python3 "<mimir>/scripts/session.py" parse-date` with `{"now": "<N>", "phrase": "<the date and time as the student gave them>"}` (escape it as a JSON string; leave the time out when they don't know it). It accepts only `YYYY-MM-DD`, today, tomorrow, an English weekday name (today's own weekday means today) and "N days" or "in N days", each optionally with a time such as `12:30` or `2pm` before or after it ("12:30 tomorrow"). Its `exam` keeps the time when one was given, else it is the date alone. When it exits 2, ask for the date as YYYY-MM-DD and the time as HH:MM in the same setup exchange. Never do date arithmetic yourself. Replace `|` and newlines in cell values with spaces.
- For each exam whose coverage the student stated, after its row is written: the course has no files yet, so its scope cannot be resolved into topics now. Note the student's words with `python3 "<mimir>/scripts/session.py" scope` and `{"now": "<N>", "code": "<CODE>", "exam_name": "<the row's exam>", "exam_date": "<parse-date's date>", "words": "<the student's words>"}` and print its `line`; the first study session of the course runs core rules' Exam scope confirm step with them. "Don't know" notes nothing. On exit 2, show its stderr line and go on.
6. Teaching-style sampler. Run `python3 "<mimir>/scripts/session.py" prefs` with `{}` and read its `sampler`:
- `open` false: skip this step and say nothing about it.
- `started` true (an interrupted setup): say "Picking up the teaching-style examples where we left off." and run `<mimir>/skills/mimir-setup/references/sampler.md` for the axes in `remaining`.
- Otherwise offer it once: "Optional: a few quick everyday examples so you can pick how I teach (about two minutes). Or say 'skip': I'll start with the default style and keep adapting as you study." Wait. A yes runs `<mimir>/skills/mimir-setup/references/sampler.md` for the axes in `remaining`. A skip or no runs `python3 "<mimir>/scripts/session.py" pref-event` with `{"event": "sampler-skip"}`; print its `line`.
7. When the last `session.py prefs` or `pref-event` output of step 6 has `whats_new` null (a new user, with no earlier sessions), run `python3 "<mimir>/scripts/session.py" pref-event` with `{"event": "whats-new-seen"}` (print nothing; on exit 2, go on): a new user never gets the what's-new line meant for users of the earlier version. A user with earlier sessions (a lazy setup) keeps it for their next study session. Then, in `.state/profile.md`, `setup_done:` set to the `date` of the step 5 `session.py now` call. Once it is set, the sampler is never offered again.
8. Say: "Drop your course outline and past papers into `<root>/_inbox/`." Teaching can start right after.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |