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

scripts/generate_table.py

View on GitHub
#!/usr/bin/env python3
"""
Table Generator (Typst) - Convert structured data to publication-ready Typst table code.

Usage:
    uv run python -B generate_table.py data.csv --style booktabs
    uv run python -B generate_table.py data.json --style booktabs --bilingual
"""

import argparse
import csv
import json
import sys
from io import StringIO
from pathlib import Path


class TableGenerator:
    """Generate Typst three-line tables and Markdown previews from structured data."""

    def __init__(self, style: str = "booktabs"):
        self.style = style

    def generate(
        self,
        headers: list[str],
        rows: list[list[str]],
        bilingual: bool = False,
        stats: bool = False,
        caption_en: str = "",
        caption_zh: str = "",
    ) -> dict:
        result = {
            "markdown": self._to_markdown(headers, rows),
            "typst": self._to_typst(headers, rows, caption_en),
            "word_tip": (
                "To create a three-line table in Word:\n"
                "1. Insert a standard table\n"
                "2. Select all -> Borders -> No Border\n"
                "3. Select header row -> add bottom border\n"
                "4. Select entire table -> add top and bottom borders\n"
                "Result: a clean three-line table."
            ),
        }

        if bilingual:
            result["captions"] = self._suggest_captions(headers, caption_en, caption_zh)
        if stats:
            result["stats_note"] = (
                "[Note. Bold values indicate best performance. "
                "\\* $p < 0.05$; \\*\\* $p < 0.01$; \\*\\*\\* $p < 0.001$.]"
            )

        return result

    def _to_markdown(self, headers: list[str], rows: list[list[str]]) -> str:
        if not headers:
            return ""

        col_widths = [len(h) for h in headers]
        for row in rows:
            for i, cell in enumerate(row):
                if i < len(col_widths):
                    col_widths[i] = max(col_widths[i], len(cell))

        lines = []
        header_cells = [h.ljust(col_widths[i]) for i, h in enumerate(headers)]
        lines.append("| " + " | ".join(header_cells) + " |")
        sep_cells = ["-" * col_widths[i] for i in range(len(headers))]
        lines.append("| " + " | ".join(sep_cells) + " |")
        for row in rows:
            padded = []
            for i in range(len(headers)):
                cell = row[i] if i < len(row) else ""
                padded.append(cell.ljust(col_widths[i]))
            lines.append("| " + " | ".join(padded) + " |")

        return "\n".join(lines)

    def _to_typst(self, headers: list[str], rows: list[list[str]], caption: str = "") -> str:
        n_cols = len(headers)
        if n_cols == 0:
            return ""

        lines = []
        lines.append("#figure(")
        lines.append("  table(")
        lines.append(f"    columns: {n_cols},")
        lines.append("    stroke: none,")
        lines.append("    table.hline(stroke: 0.8pt),")

        # Headers (bold)
        header_cells = [f"[*{h}*]" for h in headers]
        lines.append("    " + ", ".join(header_cells) + ",")
        lines.append("    table.hline(stroke: 0.5pt),")

        # Data rows
        for row in rows:
            cells = []
            for i in range(n_cols):
                cell = row[i] if i < len(row) else ""
                cells.append(f"[{cell}]")
            lines.append("    " + ", ".join(cells) + ",")

        lines.append("    table.hline(stroke: 0.8pt),")
        lines.append("  ),")

        if caption:
            lines.append(f"  caption: [{caption}],")

        lines.append(")")

        return "\n".join(lines)

    def _suggest_captions(self, headers: list[str], caption_en: str, caption_zh: str) -> dict:
        return {
            "en": caption_en or f"Comparison of {', '.join(headers[1:3])} across methods.",
            "zh": caption_zh or f"不同方法的{'、'.join(headers[1:3])}比较。",
        }


def load_csv(file_path: str) -> tuple[list[str], list[list[str]]]:
    path = Path(file_path)
    content = path.read_text(encoding="utf-8", errors="replace")
    reader = csv.reader(StringIO(content))
    all_rows = list(reader)
    if not all_rows:
        return [], []
    return all_rows[0], all_rows[1:]


def load_json(file_path: str) -> tuple[list[str], list[list[str]]]:
    path = Path(file_path)
    data = json.loads(path.read_text(encoding="utf-8"))
    return data.get("headers", []), data.get("rows", [])


def main():
    parser = argparse.ArgumentParser(
        description="Table Generator (Typst) - CSV/JSON to Typst three-line table"
    )
    parser.add_argument("data_file", help="CSV or JSON file with table data")
    parser.add_argument(
        "--style",
        choices=["booktabs", "plain"],
        default="booktabs",
        help="Table style (default: booktabs)",
    )
    parser.add_argument(
        "--bilingual", "-b", action="store_true", help="Generate bilingual captions"
    )
    parser.add_argument(
        "--stats", "-s", action="store_true", help="Add statistical significance note"
    )
    parser.add_argument("--caption-en", default="", help="English caption text")
    parser.add_argument("--caption-zh", default="", help="Chinese caption text")
    parser.add_argument("--json", "-j", action="store_true", help="Output in JSON format")

    args = parser.parse_args()

    data_path = Path(args.data_file)
    if not data_path.exists():
        print(f"[ERROR] File not found: {args.data_file}")
        sys.exit(1)

    if data_path.suffix.lower() == ".json":
        headers, rows = load_json(args.data_file)
    else:
        headers, rows = load_csv(args.data_file)

    if not headers:
        print("[ERROR] No data found in file")
        sys.exit(1)

    gen = TableGenerator(style=args.style)
    result = gen.generate(
        headers,
        rows,
        bilingual=args.bilingual,
        stats=args.stats,
        caption_en=args.caption_en,
        caption_zh=args.caption_zh,
    )

    if args.json:
        print(json.dumps(result, indent=2, ensure_ascii=False))
    else:
        print("=" * 60)
        print("Markdown Preview")
        print("=" * 60)
        print(result["markdown"])
        print()
        print("=" * 60)
        print("Typst Code (three-line)")
        print("=" * 60)
        print(result["typst"])
        if result.get("captions"):
            print()
            print("=" * 60)
            print("Bilingual Captions")
            print("=" * 60)
            print(f"EN: {result['captions']['en']}")
            print(f"ZH: {result['captions']['zh']}")
        print()
        print("=" * 60)
        print("Word Tip")
        print("=" * 60)
        print(result["word_tip"])

    sys.exit(0)


if __name__ == "__main__":
    main()
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