# Touying

> Author Typst slide decks with the Touying package. Use when creating or editing .typ presentations: applying or building Touying themes (e.g. metropolis), turning headings or #slide into slides, incremental reveals (#pause, dynamic content), speaker notes via pdfpc, and page layout config. Not for non-Typst decks (HTML, PPT, reveal.js, Marp) or ordinary non-presentation Typst documents.

- Skill: `bahayonghang/touying` (Agent Skill, multi-file: 47 files)
- Install (CLI): `npx skillmds@latest add bahayonghang/touying`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bahayonghang/touying/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: bahayonghang (https://skillmd.com/u/bahayonghang)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bahayonghang/touying

---


# Touying Author

Built-in themes: default, simple, metropolis, dewdrop, university, aqua, stargazer (local docs cover metropolis).

## Quick start

1. Import Touying + theme, apply with `#show: <theme>.with(...)`.
2. Use headings for slides; `#slide` only for custom layout/animation.
3. Centralize config in `globals.typ`, include content from separate files.

## Task routing

| Topic             | Docs                            |
| ----------------- | ------------------------------- |
| Getting started   | `docs/start.md`                 |
| Multi-file layout | `docs/multi-file.md`            |
| Slide/headings    | `docs/sections.md`              |
| Global styles     | `docs/global-settings.md`       |
| Page/layout       | `docs/layout.md`                |
| Animations        | `docs/dynamic/*.md`             |
| Speaker notes     | `docs/external/pdfpc.md`        |
| Themes            | `docs/themes/*.md`              |
| Integrations      | `docs/integration/*.md`         |
| Examples          | `references/EXAMPLES.md`        |
| Troubleshooting   | `references/TROUBLESHOOTING.md` |

## Key rules

- Use `config-page`/`config-common`, not `set page`.
- Set `slide-level` via `config-common(slide-level: n)`.
- Avoid `#pause` inside `context` blocks.
- Wrap custom slides with `touying-slide-wrapper`.
- Place `#show: appendix` after main deck.

## Templates

Use `examples/simple.typ` (minimal) or `examples/default.typ` (full).

## Errors

If `$ARGUMENTS` empty or no `.typ` file: "Error: Provide a valid .typ file path."