# Review

> Universal file review — auto-detects format and launches appropriate review agents in parallel. Use for quality review of any supported file type (.tex, .qmd, .typ, .py, .md).

- Skill: `clearsmog/review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clearsmog/review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clearsmog/review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: clearsmog (https://skillmd.com/u/clearsmog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/clearsmog/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

1. **Parse `$ARGUMENTS`** — resolve file path
2. **Detect format** from extension
3. **For `.typ` files**, read file to detect document subtype
4. **Launch agents in parallel** per routing table
5. **Collect all reports** from `quality_reports/`
6. **Synthesize** a consolidated summary table

## Output

```markdown
# 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 `/finish` instead
- For format-specific deep review, use the individual agents directly