Skip to content

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

latex-paper-en

Verified

English LaTeX academic paper assistant for existing `.tex` projects. Use this skill whenever the user wants to compile, lint, audit, or improve an English LaTeX conference or journal paper such as IEEE, ACM, Springer, NeurIPS, or ICML submissions. Trigger even when the user only mentions one paper issue, such as bibliography errors, grammar cleanup, sentence splitting, logic review, expression polishing, translation, title optimization, figure checks, pseudocode review, algorithm block cleanup, de-AI editing, experiment-section review, table structure validation, three-line table generation, abstract structure diagnosis, or journal adaptation. Also trigger for "proofread my paper", "fix my LaTeX", "prepare for submission", "check my manuscript", "improve my writing", "three-line table", "booktabs", "check abstract", "reformat for another journal", "换投", `algorithm2e`, `algorithmicx`, `algpseudocodex`, `Require/Ensure`, or "Algorithm 1" when the user has a .tex file.

FileKindSize
SKILL.mdskill md8.5 KB
agents/openai.yamlconfig390 B
evals/evals.jsonconfig7.8 KB
examples/compile-and-bibliography.mdmarkdown551 B
examples/experiment-review.mdmarkdown527 B
examples/figures-and-title.mdmarkdown513 B
examples/grammar-and-logic.mdmarkdown687 B
examples/translation-and-deai.mdmarkdown630 B
references/ABSTRACT_STRUCTURE.mdmarkdown4.9 KB
references/BEST_PRACTICES.mdmarkdown456 B
references/CITATION_STYLES.mdmarkdown4.2 KB
references/CITATION_VERIFICATION.mdmarkdown4.1 KB
references/COMMON_ERRORS.mdmarkdown2.8 KB
references/COMPILATION.mdmarkdown2.0 KB
references/DEAI_GUIDE.mdmarkdown16.8 KB
references/FORBIDDEN_TERMS.mdmarkdown1.6 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.mdmarkdown6.5 KB
references/TABLE_GUIDE.mdmarkdown3.7 KB
references/TERMINOLOGY.mdmarkdown9.9 KB
references/TRANSLATION_GUIDE.mdmarkdown11.4 KB
references/VENUES.mdmarkdown6.4 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.0 KB
references/modules/COMPILE.mdmarkdown2.8 KB
references/modules/DEAI.mdmarkdown1.0 KB
references/modules/EXPERIMENT.mdmarkdown3.8 KB
references/modules/EXPRESSION.mdmarkdown789 B
references/modules/FORMAT.mdmarkdown440 B
references/modules/GRAMMAR.mdmarkdown980 B
references/modules/LOGIC.mdmarkdown7.6 KB
references/modules/PSEUDOCODE.mdmarkdown1.7 KB
references/modules/SENTENCES.mdmarkdown575 B
references/modules/TABLES.mdmarkdown1.3 KB
references/modules/TITLE.mdmarkdown7.7 KB
references/modules/TRANSLATION.mdmarkdown1.1 KB
references/modules/WORKFLOW.mdmarkdown910 B
scripts/analyze_abstract.pyscript17.3 KB
scripts/analyze_experiment.pyscript18.1 KB
scripts/analyze_grammar.pyscript3.6 KB
scripts/analyze_logic.pyscript18.4 KB
scripts/analyze_sentences.pyscript3.6 KB
scripts/check_figures.pyscript6.4 KB
scripts/check_format.pyscript6.4 KB
scripts/check_pseudocode.pyscript11.2 KB
scripts/check_references.pyscript14.2 KB
scripts/check_tables.pyscript16.3 KB
scripts/compile.pyscript17.4 KB
scripts/deai_batch.pyscript9.9 KB
scripts/deai_check.pyscript16.4 KB
scripts/extract_prose.pyscript2.7 KB
scripts/generate_table.pyscript8.8 KB
scripts/improve_expression.pyscript3.2 KB
scripts/online_bib_verify.pyscript11.9 KB
scripts/optimize_title.pyscript15.4 KB
scripts/parsers.pyscript14.9 KB
scripts/translate_academic.pyscript5.1 KB
scripts/verify_bib.pyscript18.9 KB

scripts/check_figures.py

View on GitHub
#!/usr/bin/env python3
"""
Figure Quality Checker for Academic Papers
Checks resolution (DPI), format, and sequence of figures.

Usage:
    uv run python -B check_figures.py main.tex
    uv run python -B check_figures.py main.tex --min-dpi 300
"""

import argparse
import re
import sys
from pathlib import Path
from typing import Optional

try:
    from PIL import Image
except ImportError:  # pragma: no cover - runtime fallback
    Image = None

try:
    from parsers import get_parser
except ImportError:
    sys.path.append(str(Path(__file__).parent))
    from parsers import get_parser


class FigureChecker:
    def __init__(self, file_path: Path, min_dpi: int = 300):
        self.file_path = file_path
        self.root_dir = file_path.parent
        self.min_dpi = min_dpi
        self.content = file_path.read_text(encoding="utf-8", errors="ignore")
        self.parser = get_parser(file_path)

        # Try to find graphics path in LaTeX
        self.graphics_paths = [self.root_dir]
        self._parse_graphics_path()

    def _parse_graphics_path(self):
        r"""Parse \graphicspath{{path1}{path2}} from LaTeX."""
        match = re.search(r"\\graphicspath\{(.*?)\}", self.content, re.DOTALL)
        if match:
            paths = re.findall(r"\{([^}]+)\}", match.group(1))
            for p in paths:
                full_path = self.root_dir / p.strip()
                if full_path.exists():
                    self.graphics_paths.append(full_path)

    def find_figures(self) -> list[dict]:
        """Find all figure inclusions."""
        figures = []
        lines = self.content.split("\n")

        # LaTeX pattern: \includegraphics[options]{path}
        latex_pattern = r"\\includegraphics(?:\[[^\]]*\])?\{([^}]+)\}"
        # Typst pattern: #figure(image("path", ...)) or image("path")
        typst_pattern = r'image\("([^"]+)"'

        pattern = typst_pattern if str(self.file_path).endswith(".typ") else latex_pattern

        for i, line in enumerate(lines, 1):
            line = line.strip()
            if line.startswith(self.parser.get_comment_prefix()):
                continue

            for match in re.finditer(pattern, line):
                rel_path = match.group(1)
                resolved_path = self._resolve_path(rel_path)

                figures.append(
                    {
                        "line": i,
                        "rel_path": rel_path,
                        "abs_path": resolved_path,
                        "status": "FOUND" if resolved_path else "MISSING",
                    }
                )
        return figures

    def _resolve_path(self, rel_path: str) -> Optional[Path]:
        """Resolve image path using graphics_paths."""
        # Clean path extensions if missing (common in LaTeX)
        extensions = ["", ".pdf", ".png", ".jpg", ".jpeg", ".eps"]

        for base_path in self.graphics_paths:
            # Try exact path
            candidate = base_path / rel_path
            if candidate.exists():
                return candidate

            # Try with extensions
            for ext in extensions:
                candidate_ext = base_path / (rel_path + ext)
                if candidate_ext.exists():
                    return candidate_ext

        return None

    def check_quality(self, figure: dict) -> list[str]:
        """Check quality of a single figure."""
        issues = []
        path = figure["abs_path"]

        if not path:
            return ["File not found"]

        ext = path.suffix.lower()

        # Format check
        if ext in [".png", ".jpg", ".jpeg", ".bmp"]:
            issues.append(f"Raster format ({ext}) used. Prefer Vector (PDF/EPS).")

            # DPI check for raster images
            if Image is None:
                issues.append(
                    "Pillow not installed; skipped DPI analysis (install Pillow for DPI checks)."
                )
                return issues

            try:
                with Image.open(path) as img:
                    width, height = img.size
                    # Assume typical figure width of 3 inches if metadata missing
                    # This is a heuristic estimate
                    width / 3.0

                    # Try to get real DPI
                    info = img.info
                    if "dpi" in info:
                        dpi_x, dpi_y = info["dpi"]
                        if dpi_x < self.min_dpi or dpi_y < self.min_dpi:
                            issues.append(
                                f"Low DPI: {int(dpi_x)}x{int(dpi_y)} (Min: {self.min_dpi})"
                            )
                    else:
                        # Fallback heuristic
                        if width < 1000:  # Arbitrary threshold for "likely low res"
                            issues.append(f"Potential low resolution (Width: {width}px)")

            except Exception as e:
                issues.append(f"Cannot analyze image: {e}")

        return issues

    def run(self):
        print(f"Checking figures in {self.file_path}...")
        figures = self.find_figures()

        print(f"Found {len(figures)} figures.")
        print("-" * 60)

        issues_count = 0

        for fig in figures:
            if fig["status"] == "MISSING":
                print(f"[ERROR] Line {fig['line']}: Image not found: {fig['rel_path']}")
                issues_count += 1
                continue

            quality_issues = self.check_quality(fig)
            if quality_issues:
                print(f"[WARN]  Line {fig['line']}: {fig['rel_path']}")
                for issue in quality_issues:
                    print(f"        - {issue}")
                issues_count += 1
            else:
                print(f"[OK]    Line {fig['line']}: {fig['rel_path']}")

        print("-" * 60)
        if issues_count == 0:
            print("✅ All figures passed check.")
            sys.exit(0)
        else:
            print(f"⚠️ Found {issues_count} potential issues.")
            sys.exit(1)


def main():
    parser = argparse.ArgumentParser(description="Check figure quality")
    parser.add_argument("file", type=Path, help="Main file")
    parser.add_argument("--min-dpi", type=int, default=300, help="Minimum DPI for raster images")

    args = parser.parse_args()

    if not args.file.exists():
        print("File not found.")
        sys.exit(1)

    checker = FigureChecker(args.file, args.min_dpi)
    checker.run()


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: 196kUpdated Claude CodeCodexVerifiedInstall