bahayonghang/academic-writing-skills84 files

Typst Paper

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.

Specification
Skill ID
bahayonghang/academic-writing-skills/typst-paper
Publisher
bahayonghang
Repository
academic-writing-skills
Installs
0
Files
84
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

bahayonghang/academic-writing-skills/typst-paperInstalls these files
  • SKILL.md
  • agents/openai.yaml
  • evals/evals.json
  • evals/fixtures/anti_ai_pattern_clusters.typ
  • evals/fixtures/bare_fixture.typ
  • evals/fixtures/charged_ieee_fixture.typ
  • evals/fixtures/defensive_speculative_explanation.typ
  • evals/fixtures/refs.bib
  • evals/fixtures/refs.yml
  • evals/trigger_eval.json
  • examples/bibliography-and-pseudocode.md
  • examples/bibliography-and-title.md
  • examples/compile-and-format.md
  • examples/expression-and-translation.md
  • examples/literature-review-rewrite.md
  • references/ABSTRACT_STRUCTURE.md
  • references/AI_TONE_TERMS.md
  • references/AI_TONE_THRESHOLDS.yaml
  • references/BEST_PRACTICES.md
  • references/CITATION_STYLES.md
  • references/CITATION_VERIFICATION.md
  • references/COMMON_ERRORS.md
  • references/DEAI_GUIDE.md
  • references/DEAI_PATTERN_CLUSTERS.md
  • references/JOURNAL_ABBREVIATIONS.md
  • references/JOURNAL_ADAPTATION_WORKFLOW.md
  • references/METHOD_SECTION.md
  • references/NUMBER_UNIT_GUIDE.md
  • references/OVER_CLAIM_GUARD.md
  • references/PROTECTED_TOKENS.md
  • references/REVIEWER_PERSPECTIVE.md
  • references/STYLE_GUIDE.md
  • references/TABLE_GUIDE.md
  • references/TEMPLATES.md
  • references/TENSE_GUIDE.md
  • references/TERMINOLOGY.md
  • references/TRANSLATION_GUIDE.md
  • references/TYPST_SYNTAX.md
  • references/VENUES.md
  • references/WRITING_PHILOSOPHY.md
  • references/modules/ABSTRACT.md
  • references/modules/ADAPT.md
  • references/modules/BIBLIOGRAPHY.md
  • references/modules/CAPTION.md
  • references/modules/COMPILE.md
  • references/modules/DEAI.md
  • references/modules/EXPERIMENT.md
  • references/modules/EXPRESSION.md
  • references/modules/FORMAT.md
  • references/modules/GRAMMAR.md
  • references/modules/LITERATURE.md
  • references/modules/LOGIC.md
  • references/modules/PSEUDOCODE.md
  • references/modules/REFERENCES.md
  • references/modules/SENTENCES.md
  • references/modules/TABLES.md
  • references/modules/TITLE.md
  • references/modules/TRANSLATION.md
  • references/modules/WORKFLOW.md
  • references/skill-routing-notes.md
  • scripts/analyze_abstract.py
  • scripts/analyze_experiment.py
  • scripts/analyze_grammar.py
  • scripts/analyze_literature.py
  • scripts/analyze_logic.py
  • scripts/analyze_sentences.py
  • scripts/check_format.py
  • scripts/check_pseudocode.py
  • scripts/check_references.py
  • scripts/check_tables.py
  • scripts/compile.py
  • scripts/deai_batch.py
  • scripts/deai_check.py
  • scripts/generate_table.py
  • scripts/improve_expression.py
  • scripts/online_bib_verify.py
  • scripts/optimize_title.py
  • scripts/parsers.py
  • scripts/translate_academic.py
  • scripts/typ_loader.py
  • scripts/verify_bib.py
  • templates/acm.md
  • templates/ieee.md
  • templates/neurips.md

What this skill tells the agent

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.
ModuleUse whenPrimary commandRead next
compileTypst build, export, font, or watch issuesuv run python $SKILL_DIR/scripts/compile.py main.typreferences/modules/COMPILE.md
formatVenue/layout review for a Typst paperuv run python $SKILL_DIR/scripts/check_format.py main.typreferences/modules/FORMAT.md
bibliographyBibTeX or Hayagriva validationuv run python $SKILL_DIR/scripts/verify_bib.py references.bib --typ main.typreferences/modules/BIBLIOGRAPHY.md
grammarGrammar cleanup on Typst proseuv run python $SKILL_DIR/scripts/analyze_grammar.py main.typ --section introductionreferences/modules/GRAMMAR.md
sentencesLong or dense sentence diagnosticsuv run python $SKILL_DIR/scripts/analyze_sentences.py main.typ --section introductionreferences/modules/SENTENCES.md
logicArgument flow, funnel, closure, abstract/conclusion alignmentuv run python $SKILL_DIR/scripts/analyze_logic.py main.typ --section methodsreferences/modules/LOGIC.md
literatureRelated Work is list-like, under-compared, or missing a gapuv run python $SKILL_DIR/scripts/analyze_literature.py main.typ --section relatedreferences/modules/LITERATURE.md
expressionTone and expression polishinguv run python $SKILL_DIR/scripts/improve_expression.py main.typ --section methodsreferences/modules/EXPRESSION.md
translationChinese/English academic translationuv run python $SKILL_DIR/scripts/translate_academic.py input_zh.txt --domain deep-learningreferences/modules/TRANSLATION.md
titleGenerate, compare, or optimize Typst paper titlesuv run python $SKILL_DIR/scripts/optimize_title.py main.typ --checkreferences/modules/TITLE.md
pseudocodeReview algorithmic / algorithm-figure / lovelace blocksuv run python $SKILL_DIR/scripts/check_pseudocode.py main.typ --venue ieeereferences/modules/PSEUDOCODE.md
deaiReduce EN/ZH AI traces while preserving Typst syntaxuv run python $SKILL_DIR/scripts/deai_check.py main.typ --section introductionreferences/modules/DEAI.md
experimentExperiment-section clarity, layering, reporting qualityuv run python $SKILL_DIR/scripts/analyze_experiment.py main.typ --section experimentreferences/modules/EXPERIMENT.md
tablesTable structure validation, three-line tablesuv run python $SKILL_DIR/scripts/check_tables.py main.typreferences/modules/TABLES.md
referencesCross-reference, caption, and numbering integrityuv run python $SKILL_DIR/scripts/check_references.py main.typreferences/modules/REFERENCES.md
abstractAbstract five-element structure and word countuv run python $SKILL_DIR/scripts/analyze_abstract.py main.typreferences/modules/ABSTRACT.md
adaptJournal adaptation for a different venue(LLM-driven workflow)references/modules/ADAPT.md

Routing Rules

  • Infer the module from the request; ask only when it maps equally well to multiple incompatible modules. If 2-3 compatible checks are requested, run them in sequence (order: compile -> bibliography -> format -> pseudocode / tables -> grammar / sentences / deai -> logic / literature / experiment -> title / expression / translation / adapt), grouping output by module.
  • Polish coarse-to-fine (logic -> sentences -> lexical); see references/modules/WORKFLOW.md.
  • Decide BibTeX vs Hayagriva before running the bibliography script.
  • Prefer logic for abstract-introduction-conclusion alignment or contribution drift; literature only for Related Work synthesis/comparison/gap derivation. For whole-paper red-thread questions, run logic with --motivation-thread.
  • For graded de-AI / AIGC-dimension analysis, run deai with --tier light|medium|heavy; omitting --tier keeps the default output.
  • Keep pseudocode for algorithm-figure / algorithmic / lovelace issues even when phrased as formatting problems.
  • If a command fails, report the exact command and exit code before suggesting a fallback; never silently substitute a generic prose review.

Full routing detail: references/skill-routing-notes.md.

Required Inputs

main.typ (or the Typst entry file); optional section name for targeted analysis, bibliography path, and venue context (IEEE, ACM, Springer, ...). If arguments are missing, keep the inferred module and ask only for the missing piece.

Optional edit axes for rewrite modules — two orthogonal axes, never a single ladder:

  • --goal grammar|clarity|concision|coherence — what the edit is for (default grammar).
  • --strength minimal|moderate|restructure — how far the edit may go (default minimal, the smallest change that solves the task).
  • --tier light|medium|heavy is unrelated: it is deai detection sensitivity, never an edit-strength control.

Ask about goal, strength, or author intent only when the answer would change this edit — never as a fixed questionnaire.

Output Contract

Use this skill in a project

Open any RiverX project, search the Skills panel for bahayonghang/academic-writing-skills/typst-paper, and install it in one click.

Use this skill