{
  "markdown": "# 🎓 LaTeX Engineer Skill\n\n[![GitHub license](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![LaTeX Project OS](https://img.shields.io/badge/LaTeX-Project_OS-darkgreen.svg)](https://tug.org/)\n[![AI-powered](https://img.shields.io/badge/AI--powered-Claude_|_Gemini_|_GPT-purple.svg)](#)\n[![Agent Support](https://img.shields.io/badge/Agent_Support-Claude_Code_|_Cursor_|_Cline-orange.svg)](#agent-support)\n\nTurn your AI coding assistant into a full-blown, autonomous LaTeX engineering department. **LaTeX Engineer Skill** functions as a highly specialized LaTeX project operating system. It allows AI agents to scaffold modular document structures, compile high-quality PDFs, automatically diagnose and resolve LaTeX compiler errors, manage references, and generate ATS-compliant resumes or academic papers.\n\n---\n\n## ⚡ Core Capabilities\n\n- **🚀 Automated Scaffolding:** Instantly generates professional, modular LaTeX layouts including `main.tex`, structured subfolders (`sections/`, `figures/`, `tables/`), dynamic `Makefile` build files, and pre-configured compilation engines.\n- **⚙️ Multi-Engine Compiler Pipeline:** Automatically compiles documents using `latexmk`, with built-in configurations for `pdflatex` (standard), `xelatex` (system fonts), and `lualatex` (complex multilingual script rendering).\n- **🔍 Self-Healing & Debugging:** Parses compiler log files (`.log`) autonomously when a build fails. It isolates syntax issues, handles missing packages via automated package installations (`tlmgr`), and fixes broken commands without manual intervention.\n- **🎯 ATS-Compliant Resume Generation:** Implements layout architectures optimized specifically for Applicant Tracking Systems (ATS) to ensure resumes scan perfectly in automated parsers (single-column format, standard section headings, and table-less tables).\n- **📚 Intelligent Citation Management:** Integrates citations directly using `biblatex` and `biber`. Simply provide a DOI or citation key, and the system automatically updates `.bib` catalogs.\n\n---\n\n## 🛠️ Slash Commands\n\nInteract with the LaTeX engineering agent using standard slash commands:\n\n| Command | Action | Example Use Case |\n| :--- | :--- | :--- |\n| `/new {template}` | Generate a complete, modular folder structure for a given layout | `/new resume` or `/new ieee-paper` |\n| `/compile` | Compile the current directory into a high-fidelity PDF document | `/compile` |\n| `/fix-errors` | Analyze compilation logs and automatically repair any packages/syntax errors | `/fix-errors` |\n| `/optimize-ats` | Review formatting and apply strict rules to maximize ATS readability | `/optimize-ats` |\n| `/change-template {to}` | Seamlessly switch and refactor the document class/layout style | `/change-template acm` |\n| `/clean-build` | Clean up auxiliary compilation outputs (`.aux`, `.log`, `.out`, etc.) | `/clean-build` |\n\n---\n\n## 🔄 Core Workflow\n\nThe diagram below outlines the autonomous compile-debug loop that the LaTeX Engineer runs behind the scenes:\n\n```mermaid\ngraph TD\n    A[User Request: e.g., /new resume] --> B[Scaffold Phase]\n    B --> C[Generate Modular Folders & Makefile]\n    C --> D[Continuous Editing & Refinement]\n    D --> E[Compilation: /compile]\n    E --> F{Build Success?}\n    F -- Yes --> G[Generate High-Quality PDF]\n    F -- No --> H[Autonomous Debugging: /fix-errors]\n    H --> I[Analyze .log Output]\n    I --> J[Identify Missing Packages or Bad Syntax]\n    J --> K[Apply Auto-Fixes & Install Packages]\n    K --> E\n```\n\n---\n\n## 📋 Prebuilt Templates\n\nThe skill includes detailed layout rules and structures for a variety of academic and professional templates:\n\n* **Professional Resumes:** Fully ATS-optimized layouts and Academic CVs using `moderncv`.\n* **Academic Papers:** Strict, publication-ready layouts for major venues:\n  * **IEEE Conference & Journals** (`IEEEtran` support)\n  * **ACM Conference & Journals** (`acmart` support)\n  * **Springer LNCS** (`llncs` support)\n  * **Elsevier Journals** (`elsarticle` support)\n* **Technical Reports & Theses:** Multi-chapter reports and university thesis formats utilizing modular `sections/`.\n* **Slides & Presentations:** Clean, elegant slide layouts using the LaTeX `beamer` class.\n* **Notes & Lab Reports:** Mathematical formulations using `amsmath`, `amssymb`, and `siunitx`.\n\n---\n\n## 📥 Installation\n\nInstall the LaTeX Engineer skill across all compatible agents at once using the automated installer script:\n\n```bash\n# Clone the repository and run the install script\ngit clone https://github.com/shihabshahrier/latex-skill.git\ncd latex-skill\nbash install.sh\n```\n\n### Supported Mappings\n\nThe `install.sh` script automatically installs the skill into the following directories:\n\n| Agent / Environment | Target Installation Path |\n| :--- | :--- |\n| **Claude Code** | `~/.claude/skills/latex-engineer` |\n| **opencode** | `~/.config/opencode/skills/latex-engineer` |\n| **Gemini CLI (Antigravity)** | `~/.gemini/antigravity/skills/latex-engineer` |\n| **Codex / Amp / Goose / Kiro** | `~/.agents/skills/latex-engineer` |\n| **OpenClaw** | `~/.openclaw/workspace/skills/latex-engineer` |\n\n*For desktop environments like **Cursor**, **Windsurf**, **Cline**, or **GitHub Copilot**, the prompt rule files in `.cursor/`, `.windsurf/`, `.clinerules`, `AGENTS.md`, and `GEMINI.md` ensure global compatibility.*\n\n---\n\n## ⚡ Prerequisites\n\nTo compile PDFs locally, ensure a valid TeX distribution and compiler toolchain are installed:\n\n* **macOS:**\n  ```bash\n  # Full installation (Recommended)\n  brew install --cask mactex\n  # Minimal installation\n  brew install --cask basictex\n  ```\n* **Ubuntu / Debian:**\n  ```bash\n  sudo apt update\n  sudo apt install texlive-full latexmk\n  ```\n* **Fedora / RHEL:**\n  ```bash\n  sudo dnf install texlive-scheme-full latexmk\n  ```\n* **Windows:** Install [TeX Live](https://tug.org/texlive/) or [MiKTeX](https://miktex.org/).\n\n---\n\n## 🤝 Contributor Guide\n\nPlease help us keep the skill organized and performant. Keep the following source of truth rules in mind:\n\n> [!IMPORTANT]\n> **Source of Truth:**\n> All modifications should be made **exclusively** to the core definition in `skills/latex-engineer/SKILL.md` and reference files under `skills/latex-engineer/references/`. \n\n* Do not edit agent-specific config files directly (such as `.cursor/`, `.windsurf/`, `.clinerules`, or `AGENTS.md`). These are automatically synchronized and updated from the main definition.\n* Keep the core `SKILL.md` under **5,000 tokens** to prevent context bloating in AI systems. Place deep domain knowledge, code templates, or complex guidelines inside the `references/` directory.\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n📖 **Project page:** https://shihub.online/projects/latex-engineer\n",
  "bytes": 6769,
  "sha": "e660fff072fa349a6f4c33cd4b61c2ee1dd93285ad6f4241b9b3fa15ae76ea70",
  "repo_slug": "shihabshahrier/latex-engineer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_shihabshahrier_latex_engineer_9b07b9b8/readme"
}