Skills

Slide Excellence

Multi-agent comprehensive slide review (visual + pedagogy + proofreading, plus TikZ /...

Install

npx skills add pedrohcgs/claude-code-my-workflow --skill slide-excellence -g -a claude-code -y
Category
Documents
Updated
1mo ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Multi-agent comprehensive slide review (visual + pedagogy + proofreading, plus TikZ / parity / substance conditionally). Use when user says "full review", "excellence pass", "comprehensive check", "review everything", "pre-release review", "slide excellence", or before teaching / shipping a deck. Fanout wrapper, for a single lens, use `/visual-audit`, `/pedagogy-review`, or `/proofread` directly.

Slide Excellence Review

Run a comprehensive multi-dimensional review of lecture slides. Multiple agents analyze the file independently, then results are synthesized.

Which slide-review skill do I want?

  • /slide-excellence (this skill), multi-agent fanout (visual + pedagogy + proofread, plus TikZ / parity / substance conditionally). Best for pre-teaching or pre-release checks.
  • /visual-audit, single lens, layout/overflow/font/spacing only. Fast.
  • /pedagogy-review, single lens, narrative/prerequisites/worked-examples/notation.
  • /proofread, single lens, grammar/typos/overflow/terminology.
  • /qa-quarto, adversarial Beamer ↔ Quarto parity (critic-fixer loop).
  • /devils-advocate, 5-7 pointed challenges, not a full review.

Important: this orchestrator does conditional dispatch, it only spawns the subagents that can actually produce useful output for the given file. It does not run tikz-reviewer on a file with zero TikZ, or quarto-critic on a deck without a counterpart.

Step 1: Identify the File

Parse $ARGUMENTS for the filename. Resolve path in Quarto/ or Slides/.

Determine the file type:

  • .tex → Beamer
  • .qmd → Quarto
  • .md → Markdown slides

Step 2: Pre-flight, Detect Conditions

Before spawning any agent, probe the file to determine which reviews make sense:

FILE="$resolved_path"

# Has TikZ diagrams?
has_tikz=$(grep -c '\\begin{tikzpicture}' "$FILE" 2>/dev/null); has_tikz=${has_tikz:-0}

# For .qmd: is there a paired .tex in Slides/?
has_tex_pair="false"
if [[ "$FILE" == *.qmd ]]; then
  base="$(basename "$FILE" .qmd)"
  # Common Beamer suffixes: _Topic, _Lecture, exact match
  for candidate in "Slides/${base}.tex" "Slides/Lecture${base}.tex"; do
    if [ -f "$candidate" ]; then
      has_tex_pair="true"
      tex_pair="$candidate"
      break
    fi
  done
fi
Read the whole SKILL.md on GitHub

More in Documents