skills/tinymist/typst-test-slide/SKILL.md
This skill should be used when the user asks to 'test a slide', 'isolate a slide', 'debug a slide', 'preview a single slide', 'test this slide', 'render one slide', or when you need to visually verify a single Typst slide from a presentation in isolation. Provides the exact file setup pattern to avoid access-denied and import errors.
npx skillsauth add edwinhu/workflows typst-test-slideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Renders a single Typst slide in isolation for debugging or visual verification. This is a recipe, not a workflow.
Typst cannot access files outside its project root. Creating test files in /tmp/ causes "access denied" on every #import and #image() call. This skill provides the correct pattern.
| Error | Cause | Fix |
|-------|-------|-----|
| access denied on #import "../templates/theme.typ" | Test file is in /tmp/ (outside project root) | Put test file in output/ inside the project |
| access denied on #image(...) | Image path resolves outside project root | Use ../assets/ from output/ directory |
| file not found on #import "../../templates/theme.typ" | Wrong relative depth (used sub-slide depth instead of output/ depth) | output/ is one level deep: use ../templates/, not ../../templates/ |
| Slides don't render (just text) | Missing #show: university-theme.with(...) preamble | Include the full preamble (see template below) |
output/cat > output/test-slide.typ << 'EOF'
#import "../templates/theme.typ": *
#show: university-theme.with(
aspect-ratio: "16-9",
config-info(
title: [Test],
author: [Test],
date: datetime.today(),
institution: [UVA],
logo: image("../assets/LawP_horizontal_short_4c_RGB.png"),
),
)
#slide[
// paste slide content here
]
EOF
--root . from project roottinymist compile --root . output/test-slide.typ /tmp/test-slide.png --ppi 144
The --root . flag tells Typst that the project root is the current directory, so ../templates/ from output/ resolves correctly.
rm -f output/test-slide.typ
output/, never /tmp/ or any directory outside the project root.--root . from the project root directory.output/ go up one level: ../templates/, ../assets/.slides/XX-topic/ go up two levels: ../../templates/, ../../assets/ -- do not confuse these depths.output/ is gitignored but keeping test files around causes confusion.tools
Use when "query Dewey Data", "deweydata.io", "SafeGraph places/patterns/spend", "Advan foot traffic", "POI / points of interest", "mobility data", "dataplor", "Veraset", "PassBy", "crypto/Bitcoin ATM locations", or any pull from the Dewey Data academic marketplace (UVA/NYU Platform Subscription) via the deweypy/deweydatapy client, DuckDB, or the Dewey MCP server.
development
Use when submitting jobs to UVA HPC (Rivanna/Afton), writing Slurm scripts (sbatch/srun/squeue), converting SGE to Slurm, running compute on any Slurm-managed cluster, or building WRDS data pipelines with polars on HPC. Triggers: 'submit to HPC', 'sbatch', 'squeue', 'slurm job', 'run on Rivanna', 'run on Afton', 'HPC array job', 'convert SGE to Slurm', 'polars on HPC', 'WRDS from HPC'.
testing
Internal skill for literature review and source materialization. Called after brainstorm, before setup. NOT user-facing.
development
This skill should be used when the user asks to "add paper", "paperpile add", "fetch PDF for", "find and add", "search paperpile", "find in paperpile", "paperpile search", "label paper", "trash paper", "download paper", "paperpile index", "edit paper metadata", "update paper title", "fix paper author", "paperpile edit", "find PDF online", "search google for PDF", "resolve PDF", "fetch PDF for citation", "get full-text for DOI", "resolve cite to PDF", or any request to manage their Paperpile library or resolve a citation to a local PDF.