1solomonwakhungu/typst-dev-container / skills/typst-toolchain-version-updater
typst-toolchain-version-updater
VerifiedUpdates the Typst, Rust, and Pandoc version matrix in 1solomonwakhungu/typst-dev-container and compatible forks, keeping every container build buildable. Use when bumping the Typst version, updating the Rust or Pandoc version matrix, fixing a multi-architecture container build, running scheduled toolchain updates, handling release-asset lag, or editing the GitHub Actions updater and image publishing workflow.
Typst Toolchain Maintainer
Apply this workflow only to repositories that use the same layout and updater as
1solomonwakhungu/typst-dev-container.
Preserve the buildability rule
The newest upstream release is not necessarily usable. Adopt a release only after every artifact consumed by the Docker build exists:
- Typst needs both static musl archives:
typst-x86_64-unknown-linux-musl.tar.xzandtypst-aarch64-unknown-linux-musl.tar.xz. - Pandoc needs both Linux archives:
pandoc-<version>-linux-amd64.tar.gzandpandoc-<version>-linux-arm64.tar.gz. - Rust needs the official
rust:<version>Docker Hub tag because the Dockerfile builds from that image.
Release metadata alone does not prove these inputs are available. Preserve the
skip-forward behavior in .github/scripts/update-toolchain.py so a partially
published release does not break the scheduled update.
Update the repository
Before editing, read:
.github/scripts/update-toolchain.pyimages/typst/Dockerfileimages/typst/docker-bake.hclsrc/typst/devcontainer-template.json- the workflows that call the updater or publish images
Run the updater from the repository root. Review its diff and keep these fields in sync:
- the three buildable Typst versions in the bake matrix;
- the
LATESTTypst version; - the single Rust version in the bake matrix and Dockerfile default;
- the single Pandoc version across the bake matrix;
latestplus the three explicit Typst proposals in the template metadata.
Do not hand-select a version that the updater rejected unless the upstream artifacts have since become available and the same checks now pass.
Verify changes
Use the narrowest checks that cover the edit:
python3 .github/scripts/update-toolchain.py
docker buildx bake --print -f images/typst/docker-bake.hcl typst
When Docker is available, build at least one target. For changes to architecture
mapping, downloads, or extraction, verify both linux/amd64 and linux/arm64.
Inside a built image, check:
typst --version
pandoc --version
rustc --version
typst help watch
Also run the repository's targeted test workflow. If Docker or a second architecture is unavailable, state exactly which build remains for CI rather than claiming full verification.
Keep version-only pull requests mechanical. Explain any skipped upstream release in the PR body with the missing asset or image tag that caused the skip.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |