القائمة
Use when you need to create an academic Beamer presentation with original theme and multi-agent review.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | beamer-deck |
| description | Use when you need to create an academic Beamer presentation with original theme and multi-agent review. |
| allowed-tools | Bash(latexmk*), Bash(xelatex*), Bash(pdflatex*), Bash(biber*), Bash(bibtex*), Bash(mkdir*), Bash(ls*), Bash(R*), Bash(Rscript*), Bash(uv:*), Read, Write, Edit, Task |
| argument-hint | ["topic","content-path","or project-name"] |
| skill-dependencies | ["latex","project-deck"] |
Generate academic Beamer presentations with original themes, rhetoric-driven structure, and multi-agent review. Internalises Scott Cunningham's rhetoric framework and implements an adversarial review workflow.
Create polished, zero-warning Beamer decks for academic contexts: seminars, conference talks, teaching lectures, and working decks for coauthors. Every deck gets a custom theme, assertion-driven titles, and parallel review by rhetoric and graphics sub-agents.
NOT for project status updates — use project-deck for those.
out/, PDF stays in the source directory. Create .latexmkrc with $out_dir = 'out' and an END {} block to copy the PDF back if missing. Use latex for compilation — it handles error resolution automatically. See latex for manual config details.uv run python. Never bare python, python3, pip, or pip3..log file. Recompile until clean.\usepackage[<institution>]{user-beamer} from templates/beamer/. Options: preset-a, preset-b, preset-c, preset-d, plain. Never use default Beamer themes (Warsaw, Madrid, etc.) as-is, and never create one-off preambles. See [templates/beamer/README.md] for available custom commands and how to add institutions..bib file is used, validate it. Cross-reference all \cite{} keys against the bibliography file. See bib-validate for the full protocol.# inside a Beamer frame body is consumed by the frame parser before TikZ sees it, producing Illegal parameter number errors that cascade and resist all downstream fixes. Define ALL \tikzset{...} and .style={..., #1} entries in the preamble; use them inside frames. See ../shared/tikz-rules.md Rule 11.Full framework (Three Laws, MB/MC, Aristotelian Triad, Narrative Arc, Pyramid Principle, Devil's Advocate): ../shared/rhetoric-principles.md
Scott's original essay: resources/academics/scott-cunningham/MixtapeTools/presentations/rhetoric_of_decks.md
Apply numeric quality scoring using the shared framework and skill-specific rubric:
../shared/quality-scoring.md — severity tiers, thresholds, verdict rulesreferences/quality-rubric.md — issue-to-deduction mappings for this skillStart at 100, deduct per issue found, apply verdict. Compute the score in Phase 7 and report it in the final output.
See ../shared/rhetoric-principles.md for the full Aristotelian Triad framework. Context-specific Ethos/Pathos/Logos balance and adjustments are applied in Phase 2 based on audience type (academic seminar, conference talk, teaching lecture, working deck).
You (orchestrator)
├── Phase 1: Gather context (direct)
├── Phase 2: Design structure (direct)
├── Phase 3: Build deck (direct)
├── Phase 4: Fix all warnings (direct)
├── Phase 5: Rhetoric review (sub-agent — Explore)
├── Phase 6: Graphics review (sub-agent — Explore) ← parallel with Phase 5
└── Phase 7: Apply & finalise (direct)
Read project files, content sources, and audience brief. Ask the user clarifying questions:
Check for existing .bib files in the project. If citations are needed, note this for Phase 3.
docs/reference/talk-design.md for format-specific arcs (empirical, structural, theory, descriptive) and audience calibrationuser-beamer — colours and fonts are set by the templatePresent the outline to the user for approval before building.
figures/.tex file using the unified template: \documentclass[aspectratio=169,11pt]{beamer} + \usepackage[university]{user-beamer} (or other institution option). Use \fbinstitute and \fbemail for metadata. Custom commands: \contribcard, \phasecircle, \accentbox, \highlightbox, standoutframe environment..latexmkrc if not present ($out_dir = 'out' + END {} block to copy PDF back)latex — this handles missing packages, font conflicts, citation key mismatches, and stale cache automatically\addbibresource{references.bib} or \bibliography{} as appropriateAfter latex resolves errors, address remaining warnings (which autofix does not fix):
out/*.log for overfull/underfull hbox/vbox warnings\parbox, etc.Circuit breaker — do not spiral. If the same compile error persists after 3 different fix attempts, STOP. Do not try a fourth approach. Instead:
.tex file..log.What counts as "the same error": any error that persists at the same line family after a fix (e.g., Illegal parameter number moving from line 568 to 572 is still the same error — that is the diagnostic signature in tikz-rules.md Rule 11). A fresh Overfull on a different slide after fixing the first is a new error — reset the counter.
The cost of stopping is 2 minutes; the cost of spiraling is an hour of edits that progressively obscure the original cause. This rule overrides "recompile until clean" — zero tolerance for warnings does not mean infinite attempts on the same fix.
"Compilation success does not mean visual success." Also check for silent visual errors:
../shared/tikz-rules.md — compute Bezier depths, check gaps, verify label fit, check shape boundary clearance.arc3), compute Bézier positions using the helper functions in ../shared/tikz-rules.md § Matplotlib Extension — never guess where curves pass. Check label-to-shape clearance (Boundary Rule) and use anchor-based centering for text pairs.uv run python scripts/pdf-to-images.py <deck>.pdf to convert pages to images, then inspect each image for text overflow, element overlap, font readability, and alignment issues that are invisible in the logLaunch a sub-agent to review the .tex file against 7 criteria: narrative arc, MB/MC balance, title quality, one-idea-per-slide, transitions, Aristotelian balance, and pyramid principle.
Full prompt template: references/review-prompts.md § Rhetoric Review
Launch in parallel with Phase 5. Reviews TikZ diagrams, figure sizing, table formatting, colour consistency, typography, and numerical accuracy.
Full prompt template: references/review-prompts.md § Graphics Review
.bib file: validate all \cite{} keys resolve correctly (check log for Citation .* undefined). See bib-validate for the full cross-referencing protocol.references/quality-rubric.md, log all issues from Phases 4-6, compute score and verdictout/ by .latexmkrc)Three starting palettes (Professional, Energetic, Academic) in both LaTeX and CSS formats: ../shared/palettes.md
Use as inspiration — always create an original palette for each deck.
A completed deck directory should contain:
project/
├── deck.tex # Main Beamer file (uses user-beamer.sty)
├── deck.pdf # Compiled PDF (copied from out/ by .latexmkrc)
├── .latexmkrc # Output directory config
├── out/ # Build artifacts only
├── figures/ # Generated figures (if any)
│ ├── figure_1.png
│ └── ...
├── scripts/ # R/Python scripts that generated figures (if any)
│ ├── figure_1.R
│ └── ...
└── references.bib # Bibliography (if citations used)
.bib used: all \cite{} keys validated (see bib-validate)| Skill | When to use instead/alongside |
|---|---|
project-deck | For project status updates (supervisor meetings, coauthor handoffs) |
latex | Default compiler — used in Phase 3 for error resolution and citation audit |
latex | For manual compilation config details, .latexmkrc setup, engine selection |
proofread | For post-hoc review of text quality in the deck |
bib-validate | For thorough bibliography cross-referencing when citations are used |
literature | For finding and verifying citations to include |
quarto-deck | For HTML presentations (teaching, informal talks) instead of PDF |
quarto-course | For full course websites with multiple lectures, exercises, and navigation |
Scott's full rhetoric essay: resources/academics/scott-cunningham/MixtapeTools/presentations/rhetoric_of_decks.md
Scott's deck generation prompt: resources/academics/scott-cunningham/MixtapeTools/presentations/create_deck_prompt.md
Scott's example decks: resources/academics/scott-cunningham/MixtapeTools/presentations/examples/
Use when you need to compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.
Use when you need to extract citations from a PDF and generate a validated .bib file. Reads the PDF, identifies all referenced works, constructs BibTeX entries with metadata verification, then runs bib-validate.
Use when you need to check a LaTeX submission against a PDF assessment brief.
Use when you need to replicate a quantitative analysis in a second language (R↔Python↔Stata↔Julia) to verify correctness. Level 1 of the verification hierarchy.
Use when you need to challenge research assumptions or stress-test arguments.
Review user-facing documentation for accuracy, consistency, and completeness across private, public, nested repos, and the user manual. Use when docs feel stale, after major changes, or before sharing. (Replaces `repo-doc-audit`)