feat: create typst skill from tutorial#45
Merged
Myriad-Dreamin merged 7 commits intomainfrom Mar 15, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a portable, English-facing Typst authoring skill (single-file SKILL.md) plus a repo-local updater skill and OpenSpec documentation to define/maintain the workflow.
Changes:
- Introduces a new canonical spec for the Typst authoring skill and updates OpenSpec config/rules around spec
## Purposequality. - Adds a repo-local updater skill with a Python generator that emits a traceability JSON catalog and syncs the portable skill’s embedded grammar lookup.
- Adds archived change artifacts (proposal/design/tasks, delta spec snapshot) documenting the split between portable and maintenance responsibilities.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
openspec/specs/typst-document-authoring-skill/spec.md |
Canonical requirements for the portable skill + updater/validation workflows |
openspec/config.yaml |
Adds OpenSpec context and rules enforcing concrete ## Purpose text in canonical specs |
openspec/changes/archive/2026-03-15-create-english-typst-grammar-skill/tasks.md |
Archived task checklist for the change |
openspec/changes/archive/2026-03-15-create-english-typst-grammar-skill/specs/typst-document-authoring-skill/spec.md |
Archived delta spec requirements snapshot |
openspec/changes/archive/2026-03-15-create-english-typst-grammar-skill/proposal.md |
Archived proposal describing the split into portable vs updater skills |
openspec/changes/archive/2026-03-15-create-english-typst-grammar-skill/design.md |
Archived design decisions/risks/migration plan |
openspec/changes/archive/2026-03-15-create-english-typst-grammar-skill/.openspec.yaml |
Archive metadata for the change |
.codex/skills/update-typst-grammar-authoring/scripts/generate_grammar_catalog.py |
Generator that parses canonical Typst grammar examples and syncs the portable skill + JSON catalog |
.codex/skills/update-typst-grammar-authoring/references/grammar-catalog.json |
Generated traceability catalog (source-to-skill mapping) |
.codex/skills/update-typst-grammar-authoring/agents/openai.yaml |
Agent metadata for the updater skill |
.codex/skills/update-typst-grammar-authoring/SKILL.md |
Updater skill instructions for regeneration + verification |
.codex/skills/typst-grammar-authoring/SKILL.md |
Portable single-file skill with embedded grammar lookup + validation workflows |
.codex/skills/openspec-archive-change/SKILL.md |
Updates archive workflow to require finalizing synced spec ## Purpose text |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
.codex/skills/update-typst-grammar-authoring/scripts/generate_grammar_catalog.py
Outdated
Show resolved
Hide resolved
Comment on lines
+183
to
+185
| "~~~typ", | ||
| code, | ||
| "~~~", |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.