update-typst-grammar-authoring

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

Repositorio: typst-doc-cn/tutorial
Última actividad en el origen: 15 de marzo de 2026 a las 10:49
Idioma detectado de SKILL.md: inglés
Estrellas: 220
Forks: 29

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

4 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

openspec-archive-change

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

2026-03-15

typst-grammar-authoring

Use when authoring or validating Typst documents from canonical grammar examples, especially when you need compile, HTML, or SVG-based validation workflows.

2026-03-15

Ver todos los de este repositorio

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.