lecture-gate

Validates Quarto RevealJS lecture decks against a course pattern before approval.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill lecture-gate-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lecture-gate
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/lecture-gate
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill lecture-gate-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? A model that just wrote a lecture deck is the worst judge of whether it is right, and confident invention — fabricated quotations, unverified claims, broken structure — can propagate into student-facing materials. This Skill runs a separate acceptance gate that re-derives claims from primary sources instead of re-reading the draft. ## Core Features & Use Cases - Mechanical checks: Runs check_deck.py to report timing-cue coverage against the 90-minute budget, speaker-notes presence, [src:] source coverage, bullet density, and title style. - Structural review: Walks the deck against the five-step ladder (Tension, Core concept, Mechanism, Realistic complexity, 2026 frontier) and flags any slide that presupposes a later step. - Claim verification: Opens each [src:] source to confirm it says what the slide says, recomputes numbers, and requires dated observations for living benchmarks. - Use Case: After building class 7 of the IME AI-Applied-to-Transportation course, ask the gate to review the deck; it returns PASS, PASS WITH FIXES, or RETURN with numbered per-slide directives, then updates tracker.md from built to gated. ## Quick Start Run the lecture gate on class7.qmd to check it against lecture_pattern.md and tell me whether it passes.

Frequently Asked Questions about lecture-gate

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

FAQPage Schema
How do I check a Quarto RevealJS lecture deck before teaching it?

Run the gate on the deck file, which executes check_deck.py for mechanical metrics and then applies judgement-based checks. The script reports timing cues, speaker notes, source coverage, and bullet density, while the reviewer verifies ladder order and re-derives each [src:] claim from its source.

What does check_deck.py report for a lecture deck?

check_deck.py reports timing-cue coverage against a 90-minute budget, speaker-notes presence per slide, [src:] source-note counts, bullet density over six bullets, and topic-style titles. It reports findings but does not decide pass or fail; structural order and claim verification require the gate reviewer.

Why separate the lecture review gate from the deck authoring step?

A model that just wrote a deck is the worst judge of whether it is right, because the failure mode is confident invention rather than sloppiness. The gate re-derives claims from primary sources instead of re-reading the draft, which previously caught a fabricated quotation that had spread into five artifacts.

Can the gate fix or rewrite a lecture deck automatically?

No, the gate only reviews and issues a verdict: PASS, PASS WITH FIXES, or RETURN with numbered per-slide directives. It does not author decks from scratch, does not grade student work, and never retrofits classes that have already been taught.

What are the limitations of the automated deck checker?

The script cannot check ladder order, whether a slide presupposes a later step, whether each [src:] claim actually matches its source, or hybrid-delivery compliance. Those checks require the gate agent to walk the deck and open primary sources manually.