Typst Academic Paper Assistant

Do Not Use

Do not use this skill for:

• LaTeX-first conference or thesis projects
• DOCX/PDF-only editing without Typst source
• thesis template detection or GB/T 7714 thesis workflows
• from-scratch paper planning or literature research
• multi-perspective review, scoring, or submission gate decisions (use paper-audit)
• standalone pseudocode drafting without a paper context

Module Router

Routing Rules

• Infer the module from the user request first. Ask for the module only if the request still maps equally well to multiple incompatible modules.
• If the user requests 2-3 compatible checks, run them in sequence rather than collapsing everything into one generic review.
• Use this execution order when multiple modules are needed: compile -> bibliography -> format -> pseudocode / tables -> grammar / sentences / deai -> logic / literature / experiment -> title / expression / translation / adapt.
• For bibliography requests, decide BibTeX vs Hayagriva before running the script; do not guess the format after the fact.
• Prefer logic for abstract-introduction-conclusion alignment, introduction funnel breaks, or contribution drift; prefer literature only when the user is specifically asking for Related Work synthesis, comparison, or gap derivation.
• Keep pseudocode for algorithm-figure, algorithmic, lovelace, caption, wrapper, and IEEE-like style-hook issues even when the user phrases them as formatting problems.
• If a command fails, report the exact command and exit code before suggesting the next fallback; do not silently replace a failed script run with a generic prose review.

Required Inputs

• main.typ or the Typst entry file.
• Optional --section SECTION for targeted analysis.
• Optional bibliography path when the request targets references.
• Optional venue context when the user cares about IEEE, ACM, Springer, or similar expectations.

If arguments are missing, preserve the inferred module and ask only for the missing Typst entry file, section, bibliography path, or venue context.

Output Contract

• Return findings in Typst diff-comment style whenever possible: // MODULE (Line N) [Severity] [Priority]: Issue ...
• Report the exact command used and the exit code when a script fails.
• Preserve @cite, <label>, math blocks, and Typst macros unless the user explicitly asks for source edits.
• For literature, diagnose and offer a rewrite blueprint first; only produce revised prose when the user explicitly asks for it.

Workflow

1. Parse $ARGUMENTS, infer the active module, and keep that inference unless the user explicitly changes the target.
2. If the request combines multiple compatible concerns, run them in the routing order above and group the output by module.
3. Read only the reference file needed for that module.
4. Run the module script with uv run python ....
5. Return Typst-ready comments and next actions.
6. For bibliography requests, decide BibTeX vs Hayagriva first, then run bibliography.

Safety Boundaries

• Never invent citations, labels, or experimental claims.
• Never rewrite Typst references, labels, or math content by default.
• Keep compile diagnostics separate from prose rewrites so the user can validate each step.

Reference Map

• references/TYPST_SYNTAX.md: Typst syntax reminders and pitfalls.
• references/STYLE_GUIDE.md: paper-writing style baseline.
• references/CITATION_VERIFICATION.md: citation verification workflow.
• references/modules/: module-specific Typst commands and choices.
• references/modules/PSEUDOCODE.md: IEEE-like defaults for Typst pseudocode.

Read only the file that matches the active module.

Example Requests

• “Compile this Typst paper and tell me why the export works locally but fails in CI.”
• “Check bibliography, title, and abstract wording in my main.typ submission.”
• “Rewrite the related work in my Typst paper so it sounds like an academic dialogue rather than a paper list, but keep citation anchors untouched.”
• “Review this algorithm-figure block for IEEE-like caption, line-number, and comment issues.”
• “Review the methods section for sentence length and logic, but keep Typst labels intact.”

See examples/ for full request-to-command walkthroughs.