paper-writer
Automatically write empirical sections of academic papers in LaTeX by reading tables/figures from a PDF. Trigger when user wants to write a paper from empirical results, has tables/figures in PDF, or says "write paper" / "paper-writer" / "写论文".
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill paper-writerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of paper-writer
paper-writer scores 95/100 on our quality scale, 318th of 2,790 Automation skills we index (top 12%).
Its SKILL.md is 32 KB long, well organised into 32 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so paper-writer is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
paper-writer compared with similar skills
All 4 of these similar skills score higher than paper-writer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| paper-writer (this skill)by brycewang-stanford | 95 | 4.4k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install paper-writer?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill paper-writer. The install tabs above show the steps for each supported agent. - Which AI agents does paper-writer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is paper-writer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is paper-writer still maintained?
- The repository was last updated about 2 months ago, so paper-writer is actively maintained.
Skill content
View source on GitHubname: paper-writer description: Automatically write empirical sections of academic papers in LaTeX by reading tables/figures from a PDF. Trigger when user wants to write a paper from empirical results, has tables/figures in PDF, or says "write paper" / "paper-writer" / "写论文". allowed-tools: Read, Bash, Edit, Write, Glob, Grep, AskUserQuestion, WebSearch, WebFetch argument-hint: "[path-to-pdf]"
Paper Writer
Overview
This skill writes the empirical sections of an academic finance/economics paper in LaTeX format. The user provides a PDF containing all tables and figures. The skill reads each table/figure sequentially, asks the user for the desired word count, then writes that section following established academic writing conventions.
Scope: Introduction, Literature Review, Hypothesis Development (verbal or theoretical model), research design sections (Data and Sample, Variable Construction, Empirical Model), empirical results, and conclusion. Does NOT write: Institutional Background.
Workflow
Phase 1: Initialization
- Receive PDF path from user (via
$ARGUMENTSor ask). - Read the PDF to identify all tables and figures. Use the Read tool with the PDF file path. For large PDFs, read in page ranges (e.g.,
pages: "1-20"). - Build a section plan: Map each table/figure to its empirical section. Present the plan to the user for confirmation:
I have identified the following tables/figures and mapped them to sections:
Section | Tables/Figures | Default Words
---------------------------------|-------------------|-------------
Descriptive Statistics | Table 1, Fig 1-2 | 400
Baseline Regression | Table 2 | 650
Endogeneity | Table 3 | 800
Robustness Checks | Table 4-6 | 1000
Cross-sectional Heterogeneity | Table 7-8 | 500 per dimension
Mechanism Analysis | Table 9 | 600 per mechanism
Alternative Explanation | Table 10 | 750
Further Analysis | Table 11 | 650
Conclusion | (no table) | 350
Shall I proceed with this plan, or would you like to adjust?
- Ask for output path: Where to save the LaTeX file (default: same directory as the PDF, named
main.tex). - Scan results/ directory: Extract all
\label{}from table/figure .tex files for label synchronization.
IMPORTANT — Writing Order vs. Document Order:
The writing order follows the logic of academic paper development (empirical results first, then build context around them). The document order is the standard paper structure. These are different:
Writing Order Document Order (final assembly)
───────────── ──────────────────────────────
① Phase 2: Empirical Results → Section 1. Introduction
② Phase 3: Research Design → Section 2. Institutional Background (if needed)
③ Phase 4: Lit Review & Hypotheses → Section 3. Literature Review
④ Phase 5: Introduction + Title + → Section 4. Theoretical Framework / Hypotheses
Abstract + Inst. Bkg. Section 5. Data and Methodology
⑤ Phase 6: Conclusion → Section 6. Empirical Results
⑥ Phase 7: Assembly & Finalize → Section 7. Conclusion
References → Figures → Tables
Online Appendix → Proofs → Appendix Tables
Writing empirical results first ensures that all subsequent sections (research design, literature review, hypotheses, introduction) are grounded in the actual findings.
Phase 2: Empirical Results (WRITE FIRST)
Write the empirical sections first, as they are directly grounded in the tables/figures from the PDF. This becomes Section 6 (Empirical Results) in the final document.
For each section in the plan, follow this exact interaction pattern:
- Prompt the user:
下面开始写 [Section Name]([Table/Figure X])。需要多少词? - Wait for user input (word count number).
- Read the relevant table/figure pages from the PDF using the Read tool.
- Write the section following the prompt template and writing rules.
- Append the section directly into
main.tex. Do NOT save sections as separate.texfiles (e.g.,intro.tex,lit_review.tex). All section bodies live in a singlemain.texfile. The only\input{}calls inmain.texshould be for table/figure files inresults/. - Move to the next section.
Phase 3: Research Design (WRITE SECOND)
After completing all empirical sections, write the research design sections. These rely on the variable definition tables in the PDF and the empirical model specifications visible in the regression tables. This becomes Section 5 (Data and Methodology) in the final document. Follow the same interactive pattern as Phase 2.
For each section, prompt the user:
下面开始写 [Section Name]。需要多少词?
Write in this order:
-
Data and Sample Construction: Two sub-parts:
- Data Sources: Describe all relevant data sources (e.g., CSMAR, Wind, CNRDS, Guba) in detail.
- Sample Construction: Describe the sample construction procedure, filtering criteria, and final sample size.
-
Variable Construction: Describe how each key variable is constructed. Cover ONLY the dependent variable(s) and the core independent variable — do NOT include control variables here (controls are described in Empirical Model). Reference the variable definition table in the PDF. Cite the original papers that proposed each measure where applicable.
Subsection titles MUST reflect the actual indicator content, not generic placeholders. Read the variable definition table to identify the actual measures and name the subsections accordingly. Examples:
- If the dependent variable measures innovation output (patent counts, citations), use
\subsection{Measuring Corporate Innovation}— NOT\subsection{Dependent Variable}. - If the independent variable is investor disagreement (e.g., divergence of analyst forecasts), use
\subsection{Measuring Investor Disagreement}— NOT\subsection{Independent Variable}. - Pattern:
\subsection{Measuring [actual concept]}or\subsection{[Concept Name]}. Avoid the generic words "Dependent Variable" / "Independent Variable" in the subsection title.
- If the dependent variable measures innovation output (patent counts, citations), use
-
Empirical Model: Produce the econometric model in LaTeX equation format (use $X$ to express the vector of control variables, use Greek letters for fixed effects). Describe the empirical model and all variables in the equation. Include the description of control variables in this subsection — list the controls used, briefly justify their inclusion, and cite supporting literature. Reference the baseline regression table for the model specification. Cite methodological literature where appropriate.
-
Descriptive Statistics: Describe key variables from the summary statistics table.
Section-Specific Templates for Research Design
| Section | Key Instructions |
|---------|-----------------|
| Data and Sample Construction | Data sources (~300 words) + Sample construction (~200 words). Default ~500 words total. |
| Variable Construction | Describe ONLY the dependent variable(s) and the core independent variable. Subsection titles must reflect actual indicator content (e.g., Measuring Corporate Innovation), NOT generic words like "Dependent Variable". Reference variable definition table. Default ~600 words. |
| Empirical Model | Produce the equation in \begin{equation}...\end{equation} format. Describe each component AND describe the control variables (controls live here, not in Variable Construction). Default ~500 words. |
| Descriptive Statistics | Choose the most important variables. Report mean and other statistics. Default ~400 words. |
Phase 4: Literature Review and Hypothesis Development (WRITE THIRD)
After completing empirical results and research design, write the Literature Review and Hypothesis Development. These become Sections 3-4 in the final document. Writing these after the empirical work ensures the literature framing and hypotheses are properly aligned with the actual findings.
Step 1: Literature Review
- Analyze the paper's content (tables, figures, empirical results already written) to identify the key research themes.
- Propose a literature review plan to the user:
根据本文的研究内容,我建议 Literature Review 分为以下 [N] 个部分: 1. [Strand 1 topic and brief rationale] 2. [Strand 2 topic and brief rationale] 3. [Strand 3 topic and brief rationale] ... 请确认或调整以上分类。总共需要多少词? - Wait for user confirmation/adjustment and total word count. The AI allocates words across strands proportionally, or the user can specify per-strand word counts.
- Write each strand as a
\subsection{}under\section{Literature Review}. Follow these rules:- Cite relevant and important literature published from 2010-2026, and make sure recent top-journal work (2023-2026) is well represented (see the Reference Requirements rule below).
- All responses must be based on academic facts. Avoid generating fabricated literature / data / conclusions.
- All viewpoints and content must be annotated with supporting evidence.
- List references with DOI link in APA format at the end.
- Do NOT use bullet points. Use flowing academic prose.
- At the end of each strand, clearly state how this paper contributes to / differs from the existing literature.
- Citation ratio (Literature Review only): approximately 50%
\cite{}(前引) and 50%\citep{}(后引). Across the entire Literature Review section, count roughly equal numbers of each. Use\cite{}for sentences where the cited author is the grammatical subject ("\cite{baker2003} document...", "As argued by \cite{hall2012}..."), and\citep{}for parenthetical support ("...prior work shows X \citep{baker2003}"). After drafting each strand, review the citations and rebalance toward 50/50 if needed.
Step 2: Hypothesis Development
- Ask the user:
下面开始写 Hypothesis Development。请选择论证方式: (A) 文字论述 (verbal arguments) (B) 理论模型 (theoretical model with proofs) - Wait for user input (A or B).
Option A: Verbal Arguments (文字论述)
The number and content of hypotheses are derived from the empirical results:
- H1 (Baseline): One hypothesis corresponding to the baseline regression finding. Formulated as: "The first hypothesis is..."
- H2, H3, ... (Heterogeneity): Additional hypotheses corresponding to the cross-sectional heterogeneity results. Each hypothesis captures a moderating effect. Formulated as: "The second hypothesis is..." etc.
For each hypothesis:
- Ask:
下面开始写 Hypothesis [N](对应 [Baseline/Heterogeneity Table X])。需要多少词? - Write the argument FIRST (economic reasoning, cite literature), THEN state the hypothesis at the end.
- Pattern: reasoning → "Based on the above arguments, we propose the following hypothesis:" →
\textbf{Hypothesis [N]:} ... - The argument should incorporate the mechanisms documented in the study but should NOT mention empirical findings explicitly (write as if you do not know the results).
- Cite relevant literature from 2010-2026 to support each argument, including recent top-journal work (2023-2026) where it bears on the channel.
Option B: Theoretical Model (理论模型)
Build a formal theoretical model with propositions/theorems that correspond to the baseline result and mechanism channels.
-
Ask:
理论模型需要覆盖哪些结果?(默认:baseline + mechanism channels)需要多少词? -
Write the model in three parts under
\section{Theoretical Framework}:Part 1: Model Setup (
\subsection{Model Setup})- Describe assumptions, variable definitions, functional forms.
- Use LaTeX for all mathematical formulas.
- Present in flowi
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
