slide-excellence

Run multi-agent slide evaluations on QMD or TEX files and generate quality reports.

1.5k|2.9k|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill slide-excellence-pedrohcgs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slide-excellence
Source: https://github.com/pedrohcgs/claude-code-my-workflow/tree/main/.claude/skills/slide-excellence
Command: npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill slide-excellence-pedrohcgs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Educators and presenters often struggle to ensure lecture slides meet visual standards, pedagogical clarity, and textual accuracy across multiple files. This Skill runs a multi-agent evaluation and produces actionable reports.

Core Features & Use Cases

  • Visual Audit: checks font consistency, spacing, image balance, and layout quality; saves a visual audit report to quality_reports/[FILE]_visual_audit.md

  • Pedagogical Review: assesses narrative flow, pacing, notation, and instructional clarity; saves a pedagogy report to quality_reports/[FILE]_pedagogy_report.md

  • Proofreading: reviews grammar, notation, citations, and overall academic quality; saves a proofreading report to quality_reports/[FILE]_report.md

  • TikZ Review: validates TikZ diagrams for label overlaps and geometric accuracy (only if file contains TikZ); saves a TikZ review to quality_reports/[FILE]_tikz_review.md

  • Content Parity: for qmd files with corresponding tex, compares frames and environments to detect drift; saves a parity report to quality_reports/[FILE]_parity_report.md

  • Substance Review: optional for tex files to check domain correctness via domain-reviewer protocol; saves a substance report to quality_reports/[FILE]_substance_review.md

  • Synthesis: produces a combined summary and a quality score.

Quick Start

Run the Slide Excellence Review on a target QMD or TEX slide file to generate the quality_reports and the combined summary.

Frequently Asked Questions about slide-excellence

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

FAQPage Schema
How do I audit lecture slides for visual consistency and pedagogical gaps?

You can audit lecture slides by running a multi-agent evaluation on QMD or TEX files that checks visual consistency, pedagogical clarity, and grammar, then synthesizes results into actionable quality reports.

What is the best way to check QMD and TEX files for content parity drift?

Content parity drift is checked by comparing frames and environments between corresponding qmd and tex files, detecting discrepancies, and saving a dedicated parity report under the quality_reports directory.

Can I automatically validate TikZ diagrams for label overlaps and geometric accuracy?

Yes, TikZ diagrams are automatically validated for label overlaps and geometric accuracy when the target file contains TikZ, generating a specific tikz review report in the quality_reports folder.

Does the slide quality audit work with both QMD and TEX file formats?

The slide quality audit works with both QMD and TEX file formats, running visual, pedagogical, and proofreading checks while offering optional substance review and parity comparison for compatible files.

How do I generate automated quality reports for academic presentations?

Automated quality reports are generated by evaluating target slide files for visual, pedagogical, and textual issues, storing per-file markdown reports in quality_reports, and producing a final combined summary with a quality score.