Agent skill

typst-test-slide

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.

View SKILL.md on GitHub Repository
Stars 6
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/edwinhu/workflows/tree/main/skills/tinymist/typst-test-slide

SKILL.md

Typst Test Slide - Isolate and Render a Single Slide

Renders a single Typst slide in isolation for debugging or visual verification. This is a recipe, not a workflow.

Why This Exists

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.

Common Errors This Prevents

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)

The Pattern

1. Create the test file in output/

bash
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

2. Compile with --root . from project root

bash
tinymist 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.

3. Clean up

bash
rm -f output/test-slide.typ

Key Rules

  • Always create in output/, never /tmp/ or any directory outside the project root.
  • Always compile with --root . from the project root directory.
  • Paths from output/ go up one level: ../templates/, ../assets/.
  • Paths from slides/XX-topic/ go up two levels: ../../templates/, ../../assets/ -- do not confuse these depths.
  • Delete the test file when done. output/ is gitignored but keeping test files around causes confusion.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

edwinhu/workflows

audit-fix-loop

This skill should be used when the user asks to 'iteratively improve', 'audit and fix', 'hill-climb quality', 'grade and improve', 'score and fix', 'audit loop', 'quality loop', or needs structured iterative improvement of an artifact using scored independent audits. Also use when the user invokes a ralph loop for quality improvement rather than task completion.

6 1
Explore
edwinhu/workflows

ds-spec-reviewer

Internal skill used by ds-brainstorm at Phase 1 exit gate. Dispatches a reviewer subagent to verify SPEC.md completeness before planning. NOT user-facing.

6 1
Explore
edwinhu/workflows

pptx-render

Use when the user asks to "render pptx", "show pptx slide", "compare with pptx", "pptx to image", "export pptx slide", "original slide", "show me the original", "what does the pptx look like", or needs to extract a specific PPTX slide's content for visual comparison.

6 1
Explore
edwinhu/workflows

obsidian-organize

Organize Obsidian notes according to clawd's preferences. Use when user asks to "organize notes", "move notes to right folder", "clean up vault", "tidy vault", "file this note", or when creating new notes in the Obsidian vault. Also use when moving, renaming, or categorizing notes, or when the vault root has stray files.

6 1
Explore
edwinhu/workflows

dev-verify

This skill should be used when the user asks to 'verify completion', 'check that tests pass', 'confirm feature works', or REQUIRED Phase 7 of /dev workflow (final). Enforces fresh runtime evidence before claiming completion.

6 1
Explore
edwinhu/workflows

dev

This skill should be used when the user asks to 'start a feature', 'build a feature', 'implement a feature', 'develop', 'new feature', or needs the full 7-phase development workflow with TDD enforcement.

6 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results