# Overleaf Section Workflow

> >

- **Type:** Skill
- **Install:** `agentstack add skill-axect-skills-overleaf-section-workflow`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Axect](https://agentstack.voostack.com/s/axect)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Axect](https://github.com/Axect)
- **Source:** https://github.com/Axect/skills/tree/main/overleaf-section-workflow

## Install

```sh
agentstack add skill-axect-skills-overleaf-section-workflow
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Overleaf section workflow

A disciplined, section-by-section workflow for drafting a physics paper that lives on Overleaf, with a Korean intermediate draft and Opus-direct English translation. Designed to enforce paper-quality discipline learned from real JCAP-style drafting sessions.

## When to use

Use this skill whenever the user:
- Starts a new section of a paper drafted on Overleaf
- Iterates a Korean draft toward an English LaTeX section
- Translates a confirmed Korean draft directly into a `.tex` file
- Sets up out-of-tree builds in a `*_build` directory
- Asks for "section-by-section paper writing", "한글 초안 영어로 병합", "Overleaf 섹션 작성", or similar

Do **not** use this skill for one-shot full-paper writes; this workflow is *per-section*.

## Three-directory contract

The workflow assumes the user maintains three sibling directories under `~/zbin/OverLeaf/` (or wherever the project lives):

| Directory | Role |
|---|---|
| `~/zbin/OverLeaf//` | **Sync folder** mirrored to Overleaf via the `overleap` skill. `.tex`, `ref.bib`, `figs/` live here. **Never build here** — build artefacts would sync back to Overleaf. |
| `~/zbin/OverLeaf/_draft/` | **Korean drafts** as `section_ko.md` (one file per section). Plots embedded as markdown images. Iterated with the user before translation. |
| `~/zbin/OverLeaf/_build/` | **Out-of-tree build**. Contains `build_.sh` and all build artefacts (`.aux`, `.log`, `.pdf`, `.bbl`). Style files (`.bst`, `.sty`) and `ref.bib` are copied here at build time. |

If any of these directories does not exist, surface the gap before proceeding.

## Workflow loop (per section)

1. **Sync** the Overleaf project via `overleap` if not already mirrored.
2. **Draft the section in Korean** at `_draft/section_ko.md`:
   - Use markdown headings (`## §X.Y`), markdown bold paragraph leads (`**X.**`).
   - Math inline as `$...$`, display as `$$...$$` with explicit `\tag{X.Y}` for cross-reference.
   - Embed plots as markdown images: ``.
   - Use `\cite{key}` exactly as it will appear in LaTeX (preserves verbatim).
   - Build up narrative as: motivation → introduce families → unify → identify limitation → contribution (see `references/06_section_narrative.md`).
3. **Iterate with the user**. Specifically watch for:
   - Em-dashes (`—`, U+2014) or en-dashes (`–`, U+2013) — both are AI-style markers; replace with periods, commas, parens.
   - Forward references (`§\ref{...}`, "본 연구의 §5 에서 다룬다") in background sections.
   - Absolute language ("표준이다", "확실하다") that should be softened.
   - Novelty claims without hedging.
   - Citations whose attribution doesn't match the cited paper's actual content.
   - Plot layout issues (legend on top of curves, xlim/ylim wasting empty space).
4. **User confirms** the Korean draft is paper-grade.
5. **Translate Opus-direct into English LaTeX** at `/.tex`. **NEVER use a Sonnet subagent for translation in this skill** — the user has explicitly required Opus-only. Conversion rules in `references/05_translation_rules.md`.
6. **Copy figure PDFs** from `~/Documents/Project/Research/.../outputs//plots/` to `/figs/`.
7. **Verify the build** via `bash _build/build_.sh`. Build must produce zero `undefined` warnings.
8. **Commit-triage** the working tree at session boundaries (use the `commit-triage` skill).

## Core rules (non-negotiable)

These come from real session pain points. Do not skip.

1. **Build hygiene**: Never run `pdflatex`, `bibtex`, or any TeX command inside the Overleaf sync folder. Always build in `_build/` via the supplied `build_.sh`. If the user sees `*.aux`, `*.log`, `*.pdf` inside the sync folder, treat that as an emergency and clean it up.
2. **No em-dashes or en-dashes** in any draft or final LaTeX. They are AI-style markers; verify after every edit with `grep -cP "[\x{2013}\x{2014}]" ` (must return 0).
3. **No forward references** in background sections (§Background / §Setup). Subsequent sections may forward-reference earlier ones; earlier sections must stand alone.
4. **No "본 연구" preview** outside design statements. "본 연구는 GBP 를 채택한다" is fine. "본 연구의 §5 에서 다루는 DeCLA" is not.
5. **Citation must support the actual claim**, not just be metadata-correct. After bibtex generation, verify that the cited paper says what the body claims it says.
6. **Translation is Opus-only**. Do not delegate to Sonnet subagents in this skill, even when normal lab convention says to delegate translation. The user explicitly forbids this because translation goes directly into the paper.
7. **Plots use scienceplots `["science", "nature"]` with dpi=300, no title, no font override, no `no-latex` flag**. Save both PNG and PDF: PNG into the Korean draft, PDF into `/figs/`. Legend placement uses `bbox_to_anchor=(1.02, 0.5)` with `loc="center left"` whenever data would overlap the legend.

## Resources

- `references/00_workflow_overview.md` — sequential workflow steps with checkpoints.
- `references/01_writing_style.md` — Korean / English style rules (em-dash ban, forward-ref ban, hedged claims, paper-grade tone).
- `references/02_citation_verification.md` — three-source verification (InspireHEP / CrossRef / Scholar) and content-vs-metadata distinction.
- `references/03_plotting_conventions.md` — scienceplots conventions, legend placement, xlim/ylim tuning, plot-script directory layout.
- `references/04_build_hygiene.md` — out-of-tree build pattern, build.sh template, what to do when sync folder is contaminated.
- `references/05_translation_rules.md` — Korean markdown → English LaTeX conversion rules (with worked examples).
- `references/06_section_narrative.md` — narrative structure (motivation → introduce → unify → limitation → contribution) and how to slot a contribution claim safely.
- `references/07_lessons_log.md` — incidents and lessons from prior sessions, grouped by category.
- `templates/build_template.sh` — copy-and-rename build script (set `JOBNAME`).

## Companion skills

The workflow orchestrates several existing skills. Invoke them in turn:

| Stage | Skill |
|---|---|
| Sync | `overleap` |
| Plot generation | `scienceplot-py` (or write inline if scope is small) |
| Plot regeneration / legend fix | direct Bash + `uv run` |
| Reference search | `reference-search` (broad lit) |
| Novelty verification | `deep-research` in lit-review / fact-check mode |
| BibTeX generation | `bibtex-gen` |
| Commit | `commit-triage` |

Do not invoke these companions silently — surface what you are doing so the user can intervene.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Axect](https://github.com/Axect)
- **Source:** [Axect/skills](https://github.com/Axect/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-axect-skills-overleaf-section-workflow
- Seller: https://agentstack.voostack.com/s/axect
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.