Agent skill

Latex Scaffold

by flonat in flonat/flonat-research

Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration.

MITAuto-check passedDocuments & Office

Install Latex Scaffold

skills CLI
$ npx skills add flonat/flonat-research --skill latex-scaffold -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research latex-scaffold --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/latex-scaffold .claude/skills/latex-scaffold && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
latex-scaffold
GitHub stars
146
Token cost
~1.7k tokens
SKILL.md length
659 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration.

  • Works in 5 steps: Analyse the Draft → Create the LaTeX File → Strip Markdown Residue → …
  • Prose already exists but no LaTeX source tree does
  • SKILL.md covers When to Use, Inputs, Outputs and Workflow, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Latex Scaffold is an agent skill from flonat/flonat-research. Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration. Use when prose already exists but no LaTeX source tree does. Not for checking template drift in an existing project; use $latex-template.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering LaTeX. It works with LaTeX. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • Prose already exists but no LaTeX source tree does
  • Tasks that involve LaTeX

Example prompts

  • “/latex-scaffold”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(latexmk*), Bash(mkdir*), Bash(ls*), Glob, Grep

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Analyse the Draft
  2. Create the LaTeX File
  3. Strip Markdown Residue
  4. Wire Bibliography
  5. Compile and Verify

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(latexmk*)
    • Bash(mkdir*)
    • Bash(ls*)
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are latex).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Latex Scaffold loads about 1.7k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 659 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 659 words, ~1,663 tokens.

Download SKILL.mdSave it as .claude/skills/latex-scaffold/SKILL.md (or your agent's skills folder).
name
latex-scaffold
description
Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration. Use when prose already exists but no LaTeX source tree does. Not for checking template drift in an existing project; use $latex-template.
allowed-tools
Read, Write, Edit, Bash(latexmk*), Bash(mkdir*), Bash(ls*), Glob, Grep
argument-hint
[path/to/draft.md]
skill-dependencies
latex

LaTeX Scaffold

Convert an approved Markdown draft into a minimal, compilable LaTeX project. This is a deterministic format conversion — prose quality should already be addressed in the source draft.

When to Use

  • Converting a literature review, survey, or report from Markdown to LaTeX for PDF output
  • Turning meeting notes or drafts into a formatted document
  • Bootstrapping a LaTeX project from an existing outline
  • Any time you need md→tex without rewriting content

Inputs

  • A Markdown file (.md) — the draft to convert
  • A .bib file (optional) — if the draft contains citations

Outputs

  • A .tex file ready to compile with latex
  • The fail-closed canonical .latexmkrc if one does not already exist. Invoke the latex pre-flight to copy the canonical artifact; never synthesize selected directives.

Workflow

Step 1: Analyse the Draft

Read the Markdown file and inventory:

  • Heading structure (determine \section / \subsection depth)
  • Citations ([@Key] or [@Key1; @Key2] patterns)
  • Tables (Markdown pipe tables)
  • Math blocks ($...$ inline, $$...$$ display)
  • Figures (![caption](path))
  • Code blocks (fenced with language)
  • Whether an abstract section exists
Step 2: Create the LaTeX File

Apply these conversion rules:

MarkdownLaTeX
# Title (first H1)\title{...}
## Section\section{...}
### Subsection\subsection{...}
#### Subsubsection\subsubsection{...}
## Abstract\begin{abstract}...\end{abstract}
Headings starting with Appendix\appendix once, then \section{...}
**bold**\textbf{...}
*italic*\emph{...}
`code`\texttt{...}
[@Key]\citep{Key}
[@Key1; @Key2]\citep{Key1,Key2}
@Key (inline)\citet{Key}
$...$ / $$...$$Pass through unchanged
- item\begin{itemize}\item ...\end{itemize}
1. item\begin{enumerate}\item ...\end{enumerate}
> quote\begin{quote}...\end{quote}
![caption](path)\begin{figure}[htbp]\includegraphics{path}\caption{caption}\end{figure}
Pipe tables\begin{table}[htbp]\begin{tabular}{...}...\end{tabular}\end{table}
Fenced code blocks\begin{verbatim}...\end{verbatim}
--- (horizontal rule)\bigskip\hrule\bigskip or omit
Preamble Template
latex
\documentclass[a4paper,11pt]{article}

\usepackage[a4paper,margin=1in]{geometry}
\usepackage{hyperref}
\hypersetup{colorlinks=true,linkcolor=blue,citecolor=blue,urlcolor=blue}
\usepackage{booktabs}
\usepackage{tabularx}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{enumitem}
\usepackage[backend=biber,style=authoryear,natbib=true]{biblatex}
\addbibresource{references.bib}

\title{...}
\author{...}
\date{\today}

\begin{document}
\maketitle
% content here
\printbibliography
\end{document}

Adjust the preamble based on what the draft actually uses (e.g., skip graphicx if no figures). The natbib=true option provides \citet/\citep compatibility. If the project already uses natbib (e.g., with a journal .bst file), keep natbib — but for new scaffolds, biblatex is the default.

Step 3: Strip Markdown Residue

After conversion, scan the .tex file for any remaining Markdown syntax:

  • ## heading markers
  • ** bold markers
  • [@ citation markers
  • Pipe | table syntax
  • ![ image markers

These indicate incomplete conversion — fix them.

Step 4: Wire Bibliography
  • If a .bib file exists in the project, point \addbibresource{} to it
  • If the project has a references.bib, use that
  • If no .bib exists but citations are present, create placeholder comments: % TODO: create .bib with keys: Key1, Key2, ...
  • Ensure \printbibliography is at the end of the document (not \bibliography{})
Step 5: Compile and Verify

Run latex to compile. Verify:

  • Document compiles without errors
  • All citations resolve (or are marked as TODO)
  • Tables render correctly
  • Math renders correctly
  • Page count is reasonable

Show full SKILL.md (259 more words)Show less

Rules

  • No content rewriting — this is format conversion only. Do not improve prose, fix grammar, or reorganise sections.
  • Preserve all content — every paragraph, figure reference, and citation in the draft must appear in the .tex output.
  • Strip heading numbering — if the draft has numbered headings like 1.2 Methods, let LaTeX handle the numbering (just use \subsection{Methods}).
  • Use latex for compilation — never bare pdflatex or latexmk without out/ directory.
  • Bold caption lines like **Table 1. Description** immediately before a pipe table should become \caption{Description} inside a table float.

Cross-References

SkillWhen to use alongside
latexCompile the scaffolded .tex file
latexFor manual compilation config and .latexmkrc setup
bib-validateAfter scaffolding to verify all citation keys resolve
proofreadAfter scaffolding for grammar and consistency check
latex-templateAfter scaffolding to verify preamble aligns with the working paper template

Citation Contract

<!-- paperpile-citation-contract -->
  1. Paperpile is the only source of truth for committed citation keys and BibTeX metadata.
  2. Before writing \cite{key}, verify with paperpile get-item key and paperpile export-bib key.
  3. Resolve unknowns in order: DOI lookup → Paperpile substring search → refpile semantic search → Paperpile verify.
  4. A DOI miss is not non-membership; continue with title/author search and refpile.
  5. If unresolved, write \CiteTodo{slug}{title/author/year/DOI hint} — never a guessed key.
  6. Drafting sub-agents must not write/edit the active .bib; only the orchestrator regenerates it from Paperpile exports.
  7. Stage genuine new refs under .paperpile-import/ for manual Paperpile import; don't cite until Paperpile mints the key.
  8. Run scripts/bib/citation_lint.py before commit; zero placeholders, zero non-Paperpile keys, zero hand-authored metadata.

See rules/paperpile-citations.md for the full workflow.

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/latex-scaffold of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Latex Scaffold next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Latex Scaffold compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Latex Scaffold this skillflonat/flonat-research146—~1.7kAutomated safety check: PassMIT
Research Writingalfonso0512/research-writing-skill4901 repos~818Automated safety check: PassMIT
Paper WritingMLNLP-World/Paper-Writing-Tips4.7k—~630Automated safety check: PassNone
Evomath TaoEvoScientist/EvoSkills4782 repos~3.8kAutomated safety check: PassApache-2.0
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT
Thesis Defense PPTX Builderzouchenzhen/thesis-defense-pptx-skill266—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    490 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed
  • Paper Writing

    MLNLP-World/Paper-Writing-Tips

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    4.7k GitHub stars~630 tokensUpdated 14 days ago
    Documents & OfficeAuto-check passed
  • Evomath Tao

    EvoScientist/EvoSkills

    A skill your agent uses whenever the user submits a non-trivial mathematical claim that needs a rigorous proof or audit.

    478 GitHub starsUsed in 2 repos~3.8k tokens
    Documents & OfficeAuto-check passed
  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Thesis Defense PPTX Builder

    zouchenzhen/thesis-defense-pptx-skill

    Builds an editable thesis defense PowerPoint from a thesis PDF or LaTeX project while preserving a supplied university or lab template, then runs a visual quality check.

    266 GitHub stars~2.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 15 days ago
    Documents & OfficeAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    146 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    146 GitHub stars~4.4k tokensUpdated 11 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    146 GitHub stars~1.2k tokensUpdated 11 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    146 GitHub stars~488 tokensUpdated 11 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    146 GitHub stars~1.6k tokensUpdated 11 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    146 GitHub stars~2.8k tokensUpdated 11 days ago
    Auto-check: notes

Works with

Questions about Latex Scaffold

What does Latex Scaffold do?

Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration. Latex Scaffold is an agent skill from flonat/flonat-research. Convert an existing Markdown manuscript draft into a buildable LaTeX project with canonical structure and build configuration.

When should I use Latex Scaffold?

Latex Scaffold fits situations like: prose already exists but no LaTeX source tree does; tasks that involve LaTeX.

How do I install Latex Scaffold in Claude Code?

Run `npx skills add flonat/flonat-research --skill latex-scaffold -a claude-code`. Or copy the skill folder (skills/latex-scaffold in flonat/flonat-research) into .claude/skills/latex-scaffold in your project. Claude Code loads it when a task matches its description.

How do I install Latex Scaffold in Codex?

Run `npx skills add flonat/flonat-research --skill latex-scaffold -a codex`. Or copy the skill folder (skills/latex-scaffold in flonat/flonat-research) into .agents/skills/latex-scaffold in your project. Codex loads it when a task matches its description.

Can I use Latex Scaffold in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill latex-scaffold -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/latex-scaffold, .gemini/skills/latex-scaffold, .github/skills/latex-scaffold and .opencode/skills/latex-scaffold in your project.

What does Latex Scaffold need to run?

SKILL.md names no scripts, command-line tools or credentials: Latex Scaffold is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(latexmk*), Bash(mkdir*), Bash(ls*), Glob, Grep.

Does Latex Scaffold access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Latex Scaffold safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Latex Scaffold use?

Latex Scaffold is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Latex Scaffold use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Latex Scaffold?

Skills that share tags, products or a category with Latex Scaffold: Research Writing (alfonso0512/research-writing-skill, 490 stars), Paper Writing (MLNLP-World/Paper-Writing-Tips, 4.7k stars), Evomath Tao (EvoScientist/EvoSkills, 478 stars) and Paperjury (Spark-To-Paper-Skills/paperjury, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Latex Scaffold?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 146 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.