Skip to content

brycewang-stanford/Auto-Empirical-Research-Skills / skills/35-bahayonghang-academic-writing-skills/skills/typst-paper

typst-paper

Verified

Typst academic paper assistant for existing `.typ` paper projects in English or Chinese. Use this skill whenever the user wants to compile, audit, or improve a Typst paper, including format checks, bibliography validation for BibTeX or Hayagriva, grammar/sentence/logic review, expression polishing, translation, title optimization, pseudocode review, algorithm block cleanup, de-AI editing, experiment-section review, table structure validation, three-line table generation, abstract structure diagnosis, or journal adaptation. Trigger even when the user only mentions one Typst file, one bibliography issue, one pseudocode block, one section rewrite, "three-line table", "check abstract", or "reformat for another journal". Also trigger when the user mentions ".typ files", "typst compile error", "typst export", "typst bibliography", `algorithm-figure`, `lovelace`, or `algorithmic` even without saying the word "Typst" explicitly.

FileKindSize
SKILL.mdskill md7.5 KB
agents/openai.yamlconfig330 B
evals/evals.jsonconfig7.3 KB
examples/bibliography-and-title.mdmarkdown509 B
examples/compile-and-format.mdmarkdown495 B
examples/expression-and-translation.mdmarkdown554 B
references/ABSTRACT_STRUCTURE.mdmarkdown4.9 KB
references/BEST_PRACTICES.mdmarkdown391 B
references/CITATION_STYLES.mdmarkdown4.2 KB
references/CITATION_VERIFICATION.mdmarkdown4.9 KB
references/COMMON_ERRORS.mdmarkdown5.3 KB
references/DEAI_GUIDE.mdmarkdown14.9 KB
references/JOURNAL_ABBREVIATIONS.mdmarkdown3.5 KB
references/JOURNAL_ADAPTATION_WORKFLOW.mdmarkdown3.6 KB
references/NUMBER_UNIT_GUIDE.mdmarkdown2.3 KB
references/REVIEWER_PERSPECTIVE.mdmarkdown4.9 KB
references/STYLE_GUIDE.mdmarkdown7.9 KB
references/TABLE_GUIDE.mdmarkdown2.6 KB
references/TEMPLATES.mdmarkdown2.5 KB
references/TERMINOLOGY.mdmarkdown9.9 KB
references/TRANSLATION_GUIDE.mdmarkdown11.4 KB
references/TYPST_SYNTAX.mdmarkdown9.8 KB
references/VENUES.mdmarkdown13.0 KB
references/WRITING_PHILOSOPHY.mdmarkdown6.7 KB
references/modules/ABSTRACT.mdmarkdown1.2 KB
references/modules/ADAPT.mdmarkdown1.3 KB
references/modules/BIBLIOGRAPHY.mdmarkdown1.3 KB
references/modules/CAPTION.mdmarkdown2.1 KB
references/modules/COMPILE.mdmarkdown1.2 KB
references/modules/DEAI.mdmarkdown2.8 KB
references/modules/EXPERIMENT.mdmarkdown3.8 KB
references/modules/EXPRESSION.mdmarkdown1.6 KB
references/modules/FORMAT.mdmarkdown1.1 KB
references/modules/GRAMMAR.mdmarkdown1.1 KB
references/modules/LOGIC.mdmarkdown5.4 KB
references/modules/PSEUDOCODE.mdmarkdown1.4 KB
references/modules/SENTENCES.mdmarkdown726 B
references/modules/TABLES.mdmarkdown1.3 KB
references/modules/TITLE.mdmarkdown7.3 KB
references/modules/TRANSLATION.mdmarkdown1.5 KB
references/modules/WORKFLOW.mdmarkdown706 B
scripts/analyze_abstract.pyscript17.3 KB
scripts/analyze_experiment.pyscript11.1 KB
scripts/analyze_grammar.pyscript3.6 KB
scripts/analyze_logic.pyscript18.8 KB
scripts/analyze_sentences.pyscript3.6 KB
scripts/check_format.pyscript11.3 KB
scripts/check_pseudocode.pyscript8.6 KB
scripts/check_references.pyscript14.1 KB
scripts/check_tables.pyscript9.8 KB
scripts/compile.pyscript8.1 KB
scripts/deai_batch.pyscript10.2 KB
scripts/deai_check.pyscript19.2 KB
scripts/generate_table.pyscript6.7 KB
scripts/improve_expression.pyscript3.2 KB
scripts/online_bib_verify.pyscript11.9 KB
scripts/optimize_title.pyscript16.9 KB
scripts/parsers.pyscript8.0 KB
scripts/translate_academic.pyscript4.2 KB
scripts/verify_bib.pyscript15.1 KB

references/STYLE_GUIDE.md

View on GitHub
# Academic Writing Style Guide (Typst)


## Table of Contents

- [Core Principles](#core-principles)
  - [1. Clarity Over Complexity](#1-clarity-over-complexity)
  - [2. Precision Over Vagueness](#2-precision-over-vagueness)
  - [3. Active Voice (When Appropriate)](#3-active-voice-when-appropriate)
- [Sentence Length Guidelines](#sentence-length-guidelines)
- [Paragraph Structure](#paragraph-structure)
  - [Topic Sentence](#topic-sentence)
  - [Supporting Sentences](#supporting-sentences)
  - [Transition](#transition)
- [Academic Vocabulary](#academic-vocabulary)
  - [Reporting Verbs (Neutral)](#reporting-verbs-neutral)
  - [Reporting Verbs (Strong Agreement)](#reporting-verbs-strong-agreement)
  - [Reporting Verbs (Tentative)](#reporting-verbs-tentative)
  - [Reporting Verbs (Critical)](#reporting-verbs-critical)
- [Transition Words](#transition-words)
  - [Addition](#addition)
  - [Contrast](#contrast)
  - [Cause/Effect](#causeeffect)
  - [Example](#example)
  - [Sequence](#sequence)
- [Citation Integration (Typst Syntax)](#citation-integration-typst-syntax)
  - [Integral (Author as Subject)](#integral-author-as-subject)
  - [Non-Integral (Content Focus)](#non-integral-content-focus)
  - [Paraphrase (Preferred)](#paraphrase-preferred)
  - [Direct Quote (Sparingly)](#direct-quote-sparingly)
- [Common Section Patterns](#common-section-patterns)
  - [Introduction](#introduction)
  - [Related Work](#related-work)
  - [Methodology](#methodology)
  - [Results](#results)
  - [Conclusion](#conclusion)
- [Typst-Specific Formatting](#typst-specific-formatting)
  - [Headings](#headings)
  - [Emphasis](#emphasis)
  - [Lists](#lists)
  - [Math](#math)
  - [Figures and Tables](#figures-and-tables)
  - [Cross-references](#cross-references)

---

## Core Principles

### 1. Clarity Over Complexity
- One idea per sentence
- Avoid nested clauses when possible
- Define terms on first use

### 2. Precision Over Vagueness
- Use specific numbers instead of "several" or "many"
- Quantify claims whenever possible
- Avoid hedging without evidence

### 3. Active Voice (When Appropriate)
- ✅ "We propose a novel method..."
- ✅ "This paper presents..."
- ❌ "A novel method is proposed by us..."

## Sentence Length Guidelines

| Type | Word Count | Use Case |
|------|------------|----------|
| Short | 10-15 | Key findings, transitions |
| Medium | 15-25 | Most content |
| Long | 25-40 | Complex relationships |
| Very Long | >40 | ⚠️ Consider splitting |

## Paragraph Structure

### Topic Sentence
First sentence states the main point.

### Supporting Sentences
- Evidence, examples, or elaboration
- 3-5 sentences typical
- Clear logical flow

### Transition
Connect to next paragraph if needed.

## Academic Vocabulary

### Reporting Verbs (Neutral)
- states, notes, observes, reports, describes

### Reporting Verbs (Strong Agreement)
- demonstrates, shows, proves, confirms, establishes

### Reporting Verbs (Tentative)
- suggests, implies, indicates, proposes, hypothesizes

### Reporting Verbs (Critical)
- claims, argues, asserts, alleges, maintains

## Transition Words

### Addition
- Furthermore, Moreover, Additionally, In addition

### Contrast
- However, Nevertheless, Conversely, On the other hand

### Cause/Effect
- Therefore, Consequently, As a result, Thus

### Example
- For instance, For example, Specifically, In particular

### Sequence
- First, Second, Subsequently, Finally

## Citation Integration (Typst Syntax)

### Integral (Author as Subject)
```typst
@smith2020 demonstrated that...
According to @jones2021, the method...
```

### Non-Integral (Content Focus)
```typst
Deep learning has shown remarkable success @smith2020 @jones2021 @wang2022.
```

### Paraphrase (Preferred)
Restate the idea in your own words with citation.

### Direct Quote (Sparingly)
Only for definitions or exceptionally well-phrased ideas.

### Anti-Citation-Stacking Rules (Introduction & Related Work)

Stacking 3+ references without individual discussion is a common AI writing pattern and is unacceptable in top-tier venues. These rules apply to both Introduction and Related Work sections.

**Rules:**
1. **Max 2 clustered citations** without discussion per sentence
   - ❌ "Many methods have been proposed @smith2020 @jones2021 @wang2022 @li2023 @chen2024."
   - ✅ "@smith2020 proposed X for scenario A. Building on this, @jones2021 extended the approach to B, while @wang2022 addressed limitation C."

2. **Every cited work must earn its citation** with at least one of:
   - A summary of its core contribution (1 clause minimum)
   - A comparison with another cited work
   - A specific limitation that motivates your work

3. **Narrative over parenthetical** in Introduction and Related Work:
   - Use integral citations (author as subject) for key works: "@smith2020 demonstrated..."
   - Reserve non-integral citations for well-established facts only: "Gradient descent is widely used @smith2020 @jones2021."

4. **Funnel-appropriate density (Introduction):**
   - Background paragraph (broad context): up to 2 clustered citations for established facts
   - Problem statement paragraph: each citation must be individually discussed
   - Gap/motivation paragraph: every cited limitation must reference a specific paper

5. **Categorical discussion (Related Work):**
   - Group works by methodology/approach, not chronologically
   - Within each group, discuss each work's specific contribution and limitation
   - Use comparative language between works: "Unlike @smith2020, @jones2021 addresses..."

**Positive patterns (Introduction):**
```typst
@smith2020 proposed method X, achieving Y% accuracy on dataset Z.
However, their approach assumes A, which limits applicability to B.
@jones2021 relaxed this assumption by introducing C, but at the cost of D.
In contrast, our method addresses both limitations by...
```

**Positive patterns (Related Work):**
```typst
*Transformer-based methods.* @vaswani2017 introduced the self-attention
mechanism for sequence modeling. @li2019 adapted this architecture for
time series, but their method requires $O(n^2)$ memory. @zhou2021 proposed
ProbSparse attention to reduce complexity to $O(n log n)$, though at the
cost of approximation error.
```

**Negative patterns (FORBIDDEN):**
```typst
Many researchers have studied this problem @a2020 @b2021 @c2022 @d2023 @e2024.
Several methods have been proposed @f2020 @g2021 @h2022 @i2023 @j2024 @k2024.
```

## Common Section Patterns

### Introduction
1. General context → Specific problem
2. Gap in existing work
3. Contributions of this work
4. Paper organization

### Related Work
1. Categorize existing approaches
2. Compare and contrast
3. Position your work

### Methodology
1. Overview of approach
2. Detailed steps
3. Justification for choices

### Results
1. Experimental setup
2. Quantitative results
3. Qualitative analysis
4. Comparison with baselines

### Conclusion
1. Summary of contributions
2. Limitations
3. Future work

## Typst-Specific Formatting

### Headings
```typst
= Introduction          // Level 1
== Background          // Level 2
=== Related Work       // Level 3
```

### Emphasis
```typst
*bold text*            // Bold
_italic text_          // Italic
`code text`            // Code/monospace
```

### Lists
```typst
// Unordered list
- Item 1
- Item 2
  - Nested item

// Ordered list
+ First item
+ Second item
  + Nested item
```

### Math
```typst
// Inline math
The equation $x^2 + y^2 = z^2$ shows...

// Display math
$ x^2 + y^2 = z^2 $

// Numbered equation
$ x = (a + b) / 2 $ <eq:mean>
```

### Figures and Tables
```typst
// Figure
#figure(
  image("figure.png", width: 80%),
  caption: [Description of the figure.]
) <fig:example>

// Table
#figure(
  table(
    columns: 3,
    [Header 1], [Header 2], [Header 3],
    [Data 1], [Data 2], [Data 3],
  ),
  caption: [Description of the table.]
) <tab:example>
```

### Cross-references
```typst
As shown in @fig:example, the method...
Table @tab:example presents the results...
Equation @eq:mean defines the average...
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall