Skip to content
Skills Library
Science & research · Conversion & formats

write-slides

/write-slides

User trigger. Use when building a Typst + Touying slide deck for a scientific talk, lecture, or briefing.

Repository
sci-brain ↗
Licence
MIT
Last repository change
25.09.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
5
Deprecation

No signals detected. Repository changed on 25.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

User trigger. Use when building a Typst + Touying slide deck for a scientific talk, lecture, or briefing.

Original author description

User trigger. Use when building a Typst + Touying slide deck for a scientific talk, lecture, or briefing.

How it works

  1. Installed resources
  2. 1. Load context and agree the outline
  3. 2. Initialize the upstream template
  4. 3. Choose the theme and compose slides
  5. 4. Compile and review
  6. Template changes and existing decks
Original SKILL.md headings · 132 lines, 785 words
SKILL.md preview
---
name: write-slides
description: User trigger. Use when building a Typst + Touying slide deck for a scientific talk, lecture, or briefing.
---

## Installed resources

Keep the working directory at the user's project. Resolve this loaded `SKILL.md`
with `Path(path).resolve()` before locating resources; follow symlinks. A path
written as `skills/<name>/...` means the installed `<name>` skill's directory from
the agent's skill catalog. Locate dependencies by public skill name.

The slide template, gallery, layouts, and style documentation come from
[GiggleLiu/sci-brain-slides](https://github.com/GiggleLiu/sci-brain-slides).
Use release **v0.1.0**, package **@preview/sci-brain-slides:0.1.0**, with Typst
**0.14.0 or newer**. Check `typst --version` and `typst fonts`; the upstream
starter uses DejaVu Sans, with math and monospace fonts bundled with Typst.

# Write scientific slides

Build a PDF talk from an agreed outline, using the upstream template's `setup()`
API. The upstream repository owns the slide components and their tests. This
skill owns the research context, presentation workflow, and final deck review.
For an actual manuscript, use `write-paper`; for an in-paper figure, use
`how-to-review-figure` with the figure's authoring tools.

## 1. Load context and agree the outline

Read the relevant manuscript or `docs/discussion/*-brainstorm-ideas-log.md`.
Resolve the project KB using `how-to-download-ref` when needed. Reuse figures
from `$KB/.figures/`, the manuscript, or earlier talks, and verify that claims
and citations match the source.

Capture the topic, audience, talk duration, and main claim. Propose sections with
one claim and a figure idea for each. Get outline approval before composing the
deck; an already approved outline can be reused.

## 2. Initialize the upstream template

Initialize from the published Typst package. Typst downloads v0.1.0 and its
pinned dependencies automatically:

```sh
mkdir -p slides
typst init @preview/sci-brain-slides:0.1.0 slides/my-talk
```

Use a new deck directory rather than overwriting an existing talk. Record the
package version and compile command alongside the deck so collaborators can
repeat the setup. The first build needs network access; later builds can reuse
Typst's package cache.

Read the v0.1.0 [layout guide](https://github.com/GiggleLiu/sci-brain-slides/blob/v0.1.0/docs/layout-patterns.md)
and [style tokens](https://github.com/GiggleLiu/sci-brain-slides/blob/v0.1.0/docs/style-tokens.md)
for the API and design examples matching this release. Browse the
[gallery PDF](https://github.com/GiggleLiu/sci-brain-slides/blob/v0.1.0/docs/gallery.pdf)
for component examples; the gallery is maintained upstream and is not included
in the registry package.

## 3. Choose the theme and compose slides

Use `academic` by default; `dark` for a dark presentation background, `minimal`
for a restrained monochrome deck, `vibrant` for colorful teaching material, or
`brand` with an explicit primary color. Keep one theme throughout the talk.
The generated `main.typ` reads `theme` and `text-size` from CLI inputs.

The package binds colors, typography, layouts, and gadgets together:

```typst
#import "@preview/sci-brain-slides:0.1.0": *

#let deck = setup(theme: "academic", text-size: 22pt)
#let (twocol,) = deck.layouts
#show: deck.theme.with(config-info(
  title: [Talk title], author: [Your name], institution: [Your lab],
))
#title-slide()

== State the result in the slide title
#twocol([The evidence.], [What the evidence establishes.])

#focus-slide[The main takeaway.]
```

Bind only the layouts and gadgets used by the talk. `deck.palette` supplies
colors and `deck.sizes` supplies typography. For a custom brand, use
`setup(theme: "brand", primary: rgb("#aa1e2b"), text-size: 22pt)`.

| Slide purpose | Upstream layout or component |
|---|---|
| Figure with interpretation | `spread` and `figbox` |
| Comparison | `twocol` or `threecol` |
| Main equation or statement | `hero` |
| Related concepts | `cards` |
| Results table | `data_table` |
| Definition or theorem | `definition` or `theorem` |
| Closing statement | `focus-slide` |

`==` starts a content slide; `=` starts a section divider. Use `#pause` for
stepwise reveals. Pass image content such as `image("figures/result.svg")` to
image helpers so paths resolve relative to the talk. Optional diagrams and
annotations use the upstream `cetz-gadgets()` and `pin-gadgets()` APIs; consult
the release's layout guide before using them.

## 4. Compile and review

Compile from the project root so project figures and the canonical bibliography
remain accessible to the deck:

```sh
typst compile slides/my-talk/main.typ slides/my-talk/main.pdf \
  --root . --input theme=academic --input text-size=22
```

Inspect the rendered pages, including all reveals. Check that each title states
its slide's claim, figures and equations are legible, captions explain how to
read the evidence, and no content overflows. Split or shorten an overfull slide;
the template does not automatically shrink text. Keep emphasized quantities
with their units and use the source's own figures when available.

Run `how-to-review-figure` on figure-heavy slides. If the talk needs a
bibliography, use the resolved `$KB/references.bib`, with a path relative to the
`.typ` file. Report the source and PDF paths, package version, build command,
and any verification that could not be completed.

## Template changes and existing decks

Report template defects and propose component changes in
[the upstream repository](https://github.com/GiggleLiu/sci-brain-slides).
Keep template source and API documentation there rather than copying them into
this skill. Talks already using `@preview/sci-brain-slides:0.1.0` can use the
registry package without source changes: remove the old `--package-path`
argument from their build command and any `TYPST_PACKAGE_PATH` override pointing
to that checkout. Existing talks with their own `zoo/` copy can still compile; migrate
those talks individually to the package import and `setup()` API when requested.

Versions

The database has no other skills named write-slides.

Database snapshot: 13.11.2026 · package version 5c9fa01b63d4 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100touying
    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…
  • 100slidekit
    Create, edit, restyle or review a presentation built with slidekit (a Typst deck with slidekit.toml and lib/slidekit.typ). Use for any request about slides, a deck, a talk, a pitch, a lecture, speaker notes, a handout or the slide theme in a slidekit project — including "make a…
  • 100typst
    Typst document creation and package development. Use when: (1) Working with .typ files, (2) User mentions typst, typst.toml, or typst-cli, (3) Creating or using Typst packages, (4) Developing document templates, (5) Converting Markdown/LaTeX to Typst
  • 100typst
    Write documents in Typst — papers, spec sheets, reports, letters, slides — compile them to PDF with the pinned typst binary, read its diagnostics, and keep the pane current. Use for any request that ends in a PDF or a printed page.
  • 95teaching-lecture
    Author a Quarto reveal.js lecture deck for a class meeting. TRIGGER on "build a lecture", "slides for my class", "teaching deck", "lecture on X", "course slides", "make a lecture for week 3", "add a discussion slide". Conference and seminar decks are research-talk, the site…
  • 100typst-authoring
    This skill should be used when the user asks to "write Typst", "create a Typst document", "format in Typst", "convert to Typst", "Typst syntax", "Typst template", "Typst math", "Typst table", or works with .typ files. Provides comprehensive Typst markup, scripting, math, layout,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.