review
Universal Review
Auto-detect file format and launch the right review agents in parallel. Read-only — no fixes applied.
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.md→ Markdown
For .typ files, also detect document type from content:
- Contains
#import "@preview/polylux"or#import "@preview/touying"→ Typst slides - Contains
#import "@local/qk"→ Uses qk component library - Contains
#set page(width: 16cm, height: 9cm)or similar → Presentation - Otherwise → Typst document (guide, essay, CV, etc.)
Routing Table
| Extension | Agents (parallel) | Condition |
|---|---|---|
.tex |
proofreader + document-auditor + pedagogy-reviewer | Always |
.tex |
+ diagram-reviewer | If TikZ found (\begin{tikzpicture}) |
.qmd |
proofreader + document-auditor | Always |
.qmd |
+ quality-critic | If .tex sibling exists |
.typ |
typst-reviewer + proofreader | Always |
.typ |
+ pedagogy-reviewer | If slide format detected |
.py |
python-pro (subagent) | Always |
.md |
proofreader | Always |
Steps
- Parse
$ARGUMENTS— resolve file path - Detect format from extension
- For
.typfiles, read file to detect document subtype - Launch agents in parallel per routing table
- Collect all reports from
quality_reports/ - Synthesize a consolidated summary table
Output
# Review Summary: [Filename]
| Dimension | Agent | Critical | Major | Minor | Verdict |
|-----------|-------|----------|-------|-------|---------|
| [varies] | [agent name] | N | N | N | [status] |
## Overall: [EXCELLENT / GOOD / NEEDS WORK / POOR]
## Critical Issues (if any)
[List top issues requiring immediate attention]
## Reports Generated
- quality_reports/[file]_report.md
- quality_reports/[file]_typst_review.md
- ...
Quality Score Rubric
See typst/references/quality-gates.md for the authoritative score rubric, severity definitions, and dispatch table.
Important
- This is a read-only review — no fixes applied
- For review + fix, use
/finishinstead - For format-specific deep review, use the individual agents directly
More from clearsmog/claude-skills
typst
Syntax guide and ecosystem reference for writing Typst (.typ) files. Use this skill when writing, editing, or debugging Typst documents. Covers core syntax, common errors, packages, and best practices.
11image-search
Search the web for images (photos, logos, graphics) and download them with Typst embedding code. Use when the user needs real-world images, company logos, or existing graphics for documents.
3compile
Compile any supported file type. Detects format (.typ, .qmd, .py) and runs appropriate build command.
2qa
Adversarial quality audit loop. Critic finds issues, fixer applies fixes, loops until APPROVED (max 5 rounds). Works with any document format.
2learn
|
2deploy
Render and deploy documents to output directory for hosting. Supports Quarto slides and Typst PDFs.
2