typst-paper

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkDeclared2 observations
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass, no license.

You are a senior data scientist and expert reviewer for top-tier computer science venues (e.g., IEEE Transactions, ACM Journals, NeurIPS, ICML). You excel at processing experimental data and crafting

Audit 0.4.1 · source sha da871dac3b12 · 26 Oct 2026Report an issue or request a re-scan

• Publisherbahayonghang GitHub userOwner of the repository this skill is read from
• Source folderbahayonghang/academic-writing-skills/academic-writing-skills/typst-paperThe exact folder we audited
• LicenceNot declaredAs the repository states it
• Commit pinned for this verdictda871dac3b12A new audit runs when the source changes
• Repository statusNot archivedPushed today
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Typst paper assistant for existing .typ manuscripts in English or Chinese. Use for compile/export diagnosis, venue formatting, BibTeX/Hayagriva checks, grammar, logic, abstract/title, tables, pseudocode, related work,…

---
name: typst-paper
description: Typst paper assistant for existing .typ manuscripts in English or Chinese. Use for compile/export diagnosis, venue formatting, BibTeX/Hayagriva checks, grammar, logic, abstract/title, tables, pseudocode, related work, research-gap framing, adaptation, de-AI polish, translation, and submission readiness; use LaTeX skills for .tex.
when_to_use: >-
  Trigger on Typst/Hayagriva prompts like "fix main.typ", "typst compile error", "export PDF",
  "check bibliography.yml", "format for IEEE/ACM", "rewrite related work", "research gap",
  "table/pseudocode in Typst", "de-AI polish", or bilingual Typst paper polishing.
metadata:
  category: academic-writing
  tags:
    [
      typst,
      paper,
      chinese,
      english,
      ieee,
      acm,
      springer,
      neurips,
      compilation,
      grammar,
      bibliography,
      hayagriva,
      pseudocode,
      algorithmic,
      lovelace,
    ]
  version: "6.0.0"
  last_updated: "2026-08-29"
argument-hint: "[main.typ] [--section SECTION] [--module MODULE]"
allowed-tools: Read, Glob, Grep, Bash(uv *)
---

# Typst Academic Paper Assistant

Use this skill for targeted work on an existing Typst paper project. Route requests to the smallest useful module and keep outputs compatible with Typst source review.

## Capability Summary

- Compile Typst projects and diagnose Typst CLI issues; validate BibTeX and Hayagriva bibliographies.
- Audit format, grammar, sentences, logic, expression, tables, cross-references, abstracts, and AI traces.
- Diagnose and rewrite-plan literature review sections (theme clustering -> comparison -> gap derivation).
- Review IEEE-like pseudocode blocks (`algorithmic`, `algorithm-figure`, `lovelace`, captions, comment length).
- Improve titles, translation, and experiment-section clarity for Typst papers.

## Triggering

Use this skill when the user has an existing `.typ` paper project and wants: compile/export fixes, venue/format compliance, BibTeX/Hayagriva validation, grammar/sentence/logic/expression review, related-work or research-gap restructuring, translation or bilingual polishing, title optimization, pseudocode review, de-AI editing, or experiment-section review. Full scenario list: `references/skill-routing-notes.md`.

## Do Not Use

Not for: LaTeX-first 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/gate decisions (use `paper-audit`); standalone pseudocode drafting without a paper context.

## Module Router

> `$SKILL_DIR` is this skill's install directory (e.g. `~/.claude/skills/typst-paper`);
> substitute it (and the input file name) when running a command. All commands
> are run with `uv run python` from the user's project directory.

| Module         | Use when                                                      | Primary command                                                                              | Read next                            |
| -------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------ |
| `compile`      | Typst build, export, font, or watch issues                    | `uv run python $SKILL_DIR/scripts/compile.py main.typ`                                       | `references/modules/COMPILE.md`      |
| `format`       | Venue/layout review for a Typst paper                         | `uv run python $SKILL_DIR/scripts/check_format.py main.typ`                                  | `references/modules/FORMAT.md`       |
| `bibliography` | BibTeX or Hayagriva validation                                | `uv run python $SKILL_DIR/scripts/verify_bib.py references.bib --typ main.typ`               | `references/modules/BIBLIOGRAPHY.md` |
| `grammar`      | Grammar cleanup on Typst prose                                | `uv run python $SKILL_DIR/scripts/analyze_grammar.py main.typ --section introduction`        | `references/modules/GRAMMAR.md`      |
| `sentences`    | Long or dense sentence diagnostics                            | `uv run python $SKILL_DIR/scripts/analyze_sentences.py main.typ --section introduction`      | `references/modules/SENTENCES.md`    |
| `logic`        | Argument flow, funnel, closure, abstract/conclusion alignment | `uv run python $SKILL_DIR/scripts/analyze_logic.py main.typ --section methods`               | `references/modules/LOGIC.md`        |
| `literature`   | Related Work is list-like, under-compared, or missing a gap   | `uv run python $SKILL_DIR/scripts/analyze_literature.py main.typ --section related`          | `references/modules/LITERATURE.md`   |
| `expression`   | Tone and expression polishing                                 | `uv run python $SKILL_DIR/scripts/improve_expression.py main.typ --section methods`          | `references/modules/EXPRESSION.md`   |
| `translation`  | Chinese/English academic translation                          | `uv run python $SKILL_DIR/scripts/translate_academic.py input_zh.txt --domain deep-learning` | `references/modules/TRANSLATION.md`  |
| `title`        | Generate, compare, or optimize Typst paper titles             | `uv run python $SKILL_DIR/scripts/optimize_title.py main.typ --check`                        | `references/modules/TITLE.md`        |
| `pseudocode`   | Review `algorithmic` / `algorithm-figure` / `lovelace` blocks | `uv run python $SKILL_DIR/scripts/check_pseudocode.py main.typ --venue ieee`                 | `references/modules/PSEUDOCODE.md`   |
| `deai`         | Reduce EN/ZH AI traces while preserving Typst syntax          | `uv run python $SKILL_DIR/scripts/deai_check.py main.typ --section introduction`             | `references/modules/DEAI.md`         |
| `experiment`   | Experiment-section clarity, layering, reporting quality       | `uv run python $SKILL_DIR/s

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

1. 2026-10-26
   ✓SAFE B 89 / 100

   first audit · source da871dac3b12

Questions about typst-paper

• github.com/bahayonghang/academic-writing-skills/tree/main/academ — the audited source at commit da871dac3b12 and every finding aboveObserved · 26 Oct 2026

Spotted something wrong? Report a correction · Methodology