How do I install the Excellence skill?

Run npx skillmds@latest add clearsmog/excellence in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Excellence safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Excellence?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Excellence free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Excellence?

clearsmog (@clearsmog) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Excellence by clearsmog — Agent Skill

Name: Excellence
Author: clearsmog

File contents

Excellence Review

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

Format Detection

Determine file type from extension:

.tex → Beamer LaTeX slides
.qmd → Quarto RevealJS slides
.typ → Typst document (slides, docs, guides, CVs)
.py → Python script

For .typ files, also detect document type from content.

Agent Dispatch by File Type

For `.tex` files:

Agent	What It Checks	Report
document-auditor	Overflow, font consistency, spacing, images	`[FILE]_visual_audit.md`
pedagogy-reviewer	13 patterns, narrative, pacing, notation	`[FILE]_pedagogy_report.md`
proofreader	Grammar, typos, consistency, academic quality	`[FILE]_report.md`
diagram-reviewer	Label overlaps, geometric accuracy (only if TikZ present)	`[FILE]_tikz_review.md`
domain-reviewer	Field-specific substance (optional)	`[FILE]_substance_review.md`

For `.qmd` files:

Agent	What It Checks	Report
document-auditor	Overflow, font consistency, spacing, images	`[FILE]_visual_audit.md`
pedagogy-reviewer	13 patterns, narrative, pacing	`[FILE]_pedagogy_report.md`
proofreader	Grammar, typos, consistency	`[FILE]_report.md`
quality-critic	Adversarial comparison vs .tex (only if sibling exists)	`[FILE]_parity_report.md`

For `.typ` files:

Agent	What It Checks	Report
typst-reviewer	Compilation, smart defaults, component usage, visual routing	`[FILE]_typst_review.md`
document-auditor	Overflow, typography, component fatigue, spacing	`[FILE]_visual_audit.md`
proofreader	Grammar, typos, consistency	`[FILE]_report.md`
pedagogy-reviewer	Narrative, pacing, notation (only if slides detected)	`[FILE]_pedagogy_report.md`

For `.py` files:

Agent	What It Checks	Report
python-pro (subagent)	Code quality, style, type safety, patterns	`[FILE]_python_review.md`
domain-reviewer	Field-specific correctness (optional)	`[FILE]_substance_review.md`

Steps

Parse $ARGUMENTS for the filename, resolve path
Detect format from extension
Launch all applicable agents in parallel per dispatch table
Collect all reports from quality_reports/
Synthesize combined summary

Combined Summary Format

# Excellence Review: [Filename]

## Overall Quality Score: [EXCELLENT / GOOD / NEEDS WORK / POOR]

| Dimension | Agent | Critical | Major | Minor |
|-----------|-------|----------|-------|-------|
| Visual/Layout | [auditor] | N | N | N |
| Content Quality | [reviewer] | N | N | N |
| Proofreading | proofreader | N | N | N |
| [Additional] | [agent] | N | N | N |

### Critical Issues (Immediate Action Required)
### Major Issues (Next Revision)
### Recommended Next Steps

Quality Score Rubric

See typst/references/quality-gates.md for the authoritative score rubric and severity definitions.

---name: excellencedescription: Multi-agent document review (visual, pedagogy, proofreading, domain). Use for comprehensive quality check before milestones. Works with any supported file type.---# Excellence ReviewRun a comprehensive multi-dimensional review. Multiple agents analyze the file independently, then results are synthesized.## Format DetectionDetermine file type from extension:- `.tex` → Beamer LaTeX slides- `.qmd` → Quarto RevealJS slides- `.typ` → Typst document (slides, docs, guides, CVs)- `.py` → Python scriptFor `.typ` files, also detect document type from content.## Agent Dispatch by File Type### For `.tex` files:| Agent | What It Checks | Report ||-------|---------------|--------|| document-auditor | Overflow, font consistency, spacing, images | `[FILE]_visual_audit.md` || pedagogy-reviewer | 13 patterns, narrative, pacing, notation | `[FILE]_pedagogy_report.md` || proofreader | Grammar, typos, consistency, academic quality | `[FILE]_report.md` || diagram-reviewer | Label overlaps, geometric accuracy (only if TikZ present) | `[FILE]_tikz_review.md` || domain-reviewer | Field-specific substance (optional) | `[FILE]_substance_review.md` |### For `.qmd` files:| Agent | What It Checks | Report ||-------|---------------|--------|| document-auditor | Overflow, font consistency, spacing, images | `[FILE]_visual_audit.md` || pedagogy-reviewer | 13 patterns, narrative, pacing | `[FILE]_pedagogy_report.md` || proofreader | Grammar, typos, consistency | `[FILE]_report.md` || quality-critic | Adversarial comparison vs .tex (only if sibling exists) | `[FILE]_parity_report.md` |### For `.typ` files:| Agent | What It Checks | Report ||-------|---------------|--------|| typst-reviewer | Compilation, smart defaults, component usage, visual routing | `[FILE]_typst_review.md` || document-auditor | Overflow, typography, component fatigue, spacing | `[FILE]_visual_audit.md` || proofreader | Grammar, typos, consistency | `[FILE]_report.md` || pedagogy-reviewer | Narrative, pacing, notation (only if slides detected) | `[FILE]_pedagogy_report.md` |### For `.py` files:| Agent | What It Checks | Report ||-------|---------------|--------|| python-pro (subagent) | Code quality, style, type safety, patterns | `[FILE]_python_review.md` || domain-reviewer | Field-specific correctness (optional) | `[FILE]_substance_review.md` |## Steps1. **Parse `$ARGUMENTS`** for the filename, resolve path2. **Detect format** from extension3. **Launch all applicable agents in parallel** per dispatch table4. **Collect all reports** from `quality_reports/`5. **Synthesize combined summary**## Combined Summary Format```markdown# Excellence Review: [Filename]## Overall Quality Score: [EXCELLENT / GOOD / NEEDS WORK / POOR]| Dimension | Agent | Critical | Major | Minor ||-----------|-------|----------|-------|-------|| Visual/Layout | [auditor] | N | N | N || Content Quality | [reviewer] | N | N | N || Proofreading | proofreader | N | N | N || [Additional] | [agent] | N | N | N |### Critical Issues (Immediate Action Required)### Major Issues (Next Revision)### Recommended Next Steps```## Quality Score RubricSee `typst/references/quality-gates.md` for the authoritative score rubric and severity definitions.

Frequently asked questions

Excellence