typst-paper

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
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-09"
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