--- slug: "course-study" source_type: "clawhub" source_url: "https://clawhub.ai/skills/course-study" repo: "" source_file: "description" --- --- name: course-study description: >- Turn a course's materials (slides, a topic list, or a course name) into complete-coverage, Feynman-explained, exam-ready revision notes. Use to study/revise a course or build an exam cheat sheet: "revise these slides", "$course-study". Do NOT use to do the user's graded homework for submission. license: MIT metadata: version: 3.0.2 model: claude-sonnet-4-6 user-invocable: true author: claude-code domains: - education - study - exam-prep - learning --- # Course Study v3.0 A lean four-phase workflow that turns a course into **complete-coverage, Feynman-explained, exam-ready revision notes**. The #1 guarantee is **completeness** (every topic covered, nothing silently dropped); the defining pedagogy is the **Feynman concept block** (plain-language capsule first + mandatory worked example). Primary output: **`revision-notes.md`**. Optional: a one-line-per-entry **`quick-reference.md`** cheat sheet, and PDF export (CJK/bilingual aware). This file is a thin orchestrator — load the `rules/` module for each phase. --- ## Pipeline ``` Phase 0 Intake (single exchange) ├── PDF slides → Phase 1 (extract via /pdf skill) ├── Topic list → Phase 1 (parse into the checklist) └── Course name → search standard syllabus → Phase 1 Phase 1 Cover → extract ALL content (page-aligned) + EMIT the coverage checklist (the ledger) Phase 2 Distill → revision-notes.md in Feynman block order; RECONCILE against the Phase-1 checklist Phase 3 Supplement (OPTIONAL, light) → ≤~10 sourced targets for genuine gaps / thin concepts VERIFY/REPORT → coverage reconciled, examples present, sources traced; emit files ``` Each phase ends with a **one-line checkpoint**; proceed on no-objection. Never spread intake across multiple messages. - **Phase 0 — Intake:** load `rules/phase-intake.md`. One exchange: input type, rough page count → scale tier, output language, exam date, priority topics, output folder; detect web access silently. - **Phase 1 — Cover:** load `rules/phase-cover.md`. Extract every concept page-aligned (PDF via the `/pdf` skill; or parse the topic list; or build the outline from a searched standard syllabus). **Emit the coverage checklist** enumerating every topic — the completeness ledger Phase 2 reconciles against. - **Phase 2 — Distill (main deliverable):** load `rules/phase-distill.md`. Write `revision-notes.md` in backbone order, each concept in the **Feynman block order** below, with cross-topic bridges. Then **reconcile** the notes against the Phase-1 checklist — flag and fill any missing topic before finalizing. - **Phase 3 — Supplement (optional, light):** load `rules/phase-supplement.md` only for genuine gaps / thin concepts. Cap **≤~10** targets. Dual web / no-web. --- ## The Feynman concept block (Phase 2 — mandatory order) Every concept is written in this exact 5-part order, **plain-language capsule FIRST** (never lead with the formal definition): **(1) capsule** → **(2) intuition** → **(3) formal treatment** → **(4) worked example** (mandatory for every non-trivial concept) → **(5) connections + common misconception**. The full per-part prose lives verbatim in `rules/phase-distill.md` (Step 2). Full template and depth calibration: `rules/phase-distill.md` and `rules/templates.md` — load them in Phase 2. --- ## Global Rules (controls) 1. **PDF-only input via /pdf.** ALL PDF reading — including scanned / image-only PDFs — goes through the `/pdf` skill. NEVER raw file I/O or Python on PDFs. Non-PDF inputs (PPTX/DOCX/images) are converted via `/pdf` first. 2. **Completeness invariant.** Phase 2 notes are reconciled against the Phase-1 coverage checklist before finalizing. Any extracted/checklist topic missing from the notes is flagged and filled — **never silently dropped or skipped.** 3. **Worked-example invariant.** Every non-trivial concept gets a concrete worked example. A pure-definition concept with **no feasible** example gets the plain-language capsule + a short note (e.g. "definitional — no worked example applies") — **never a fabricated/forced example.** 4. **No fabrication.** Offline supplements are marked `[Standard curriculum knowledge]`; ZERO invented URLs / papers / authors / slide content. Uncertain claims are omitted or flagged `[Uncertain — verify before exam]`. On the course-name path, never fabricate a specific lecture's slide content. 5. **Source traceability.** Every note traces to its source location: page (PDF, `Lecture X, p. Y`) or section (topic list / syllabus). Never lose it. 6. **Honor the source.** A slide that contradicts standard curriculum is **flagged as a discrepancy** (show the slide's claim + the standard view) — NOT silently "corrected" to the textbook version. 7. **Scale guard.** **Size** picks the tier — page count (PDF) or topic count (topic list / syllabus): large inputs (>~400 pages, or >~150 topics) → split, recommend per-module runs and batch; the checklist spans the whole course so nothing is silently dropped across batches. 8. **Scope guard.** Produce revision material, not answers to graded assessments. Do NOT solve / do the user's actual homework or exam questions for submission; offer how to approach them as a study topic instead. 9. **Output discipline.** Dense notes, no padding. `quick-reference.md` (if produced) is **one line per entry**, ordered by exam relevance — no prose. **Completeness of coverage is non-negotiable — never drop a topic to be brief.** If the user wants brevity, satisfy it via **depth calibration** (more topics at minimal capsule depth) and/or the `quick-reference.md` cheat sheet, never by omitting topics. 10. **Track progress.** Use a TodoList for which lectures/topics are processed. 11. **Prioritize flagged topics.** Priority topics named in Phase 0 get deeper treatment and appear first in `quick-reference.md`. --- ## Reference Files | File | When to load | |------|--------------| | `rules/phase-intake.md` | Phase 0 — single-exchange intake, scale tier, web detection. | | `rules/phase-cover.md` | Phase 1 — page-aligned extraction + the coverage checklist (ledger). | | `rules/phase-distill.md` | Phase 2 — Feynman blocks, bridges, the coverage reconciliation step. | | `rules/phase-supplement.md` | Phase 3 — optional light supplement, dual web/no-web, ≤~10 cap. | | `rules/templates.md` | Writing rules + the Feynman concept-block & quick-reference templates. | | `rules/subject-coverage.md` | Course-name input & standard-syllabus search; checklist baseline. | | `rules/pdf-export.md` | Load **only** when PDF output is requested (pandoc CJK/bilingual config). | | `rules/anti-patterns.md` | The consolidated do-NOT table (negative form of the Global Rules). | | `rules/changelog.md` | Version history. | --- ## Anti-Patterns The Global Rules above are the positive invariants; their negative-form restatement — the full do-NOT table (lead-with-definition, skip-worked-example, fabricate-example, skip-reconciliation, silently-fix-slide, drop-topic-for-brevity, Python-on-PDF, invent-URLs, prose-in-cheat-sheet, build-Q&A-bank) — lives in `rules/anti-patterns.md`. Each phase file reinforces the ones relevant to it.