update-typst-grammar-authoring

Use when maintaining the portable typst-grammar-authoring skill from this repository's canonical Typst grammar source.

Repository: typst-doc-cn/tutorial
Last source activity: March 15, 2026 at 10:49
Detected SKILL.md language: English
Stars: 220
Forks: 29

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/typst-doc-cn/tutorial --skill update-typst-grammar-authoring

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

4 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Update Typst Grammar Authoring

Use this skill when a maintainer needs to refresh the portable typst-grammar-authoring skill after changing the canonical grammar examples in src/tutorial/reference-grammar.typ.

Inputs And Outputs

Canonical source: src/tutorial/reference-grammar.typ

Portable skill: .codex/skills/typst-grammar-authoring/SKILL.md

Traceability artifact: .codex/skills/update-typst-grammar-authoring/references/grammar-catalog.json

Workflow

Review the source edits in src/tutorial/reference-grammar.typ and confirm they are ready to publish into the portable skill.

Regenerate the portable skill body and traceability artifact:

python .codex/skills/update-typst-grammar-authoring/scripts/generate_grammar_catalog.py

Review the generated diff for the portable skill and the traceability JSON:

git diff -- .codex/skills/typst-grammar-authoring/SKILL.md .codex/skills/update-typst-grammar-authoring/references/grammar-catalog.json

Verify the portable skill stayed single-file:

Get-ChildItem -Force .codex/skills/typst-grammar-authoring

Verify the portable skill's command examples stayed platform-neutral and did not reintroduce Windows absolute paths:

rg -n "[A-Za-z]:\\\\|path\\\\to|target\\\\typst-grammar-authoring-check|\\.codex\\\\skills|src\\\\tutorial" .codex/skills/typst-grammar-authoring/SKILL.md

If the regenerated lookup looks correct, keep the portable skill focused on author guidance only. Any exact source mapping belongs in the updater-owned traceability JSON, not in the portable SKILL.md.

Guardrails

Keep the distributed typst-grammar-authoring folder limited to SKILL.md.

Treat .codex/skills/update-typst-grammar-authoring/references/grammar-catalog.json as the source-mapping artifact for maintainers.

Keep maintenance-only commands, source-path references, and review steps in this updater skill rather than the portable one.

If the generator output reveals a design issue in the portable skill, update the portable template first and rerun the generator before final review.