# 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).

- **Type:** Skill
- **Install:** `agentstack add skill-clearsmog-claude-skills-review`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [clearsmog](https://agentstack.voostack.com/s/clearsmog)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [clearsmog](https://github.com/clearsmog)
- **Source:** https://github.com/clearsmog/claude-skills/tree/main/review
- **Website:** https://github.com/clearsmog/claude-skills

## Install

```sh
agentstack add skill-clearsmog-claude-skills-review
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [clearsmog](https://github.com/clearsmog)
- **Source:** [clearsmog/claude-skills](https://github.com/clearsmog/claude-skills)
- **License:** MIT
- **Homepage:** https://github.com/clearsmog/claude-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-clearsmog-claude-skills-review
- Seller: https://agentstack.voostack.com/s/clearsmog
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
