paper-version
Convert a LaTeX research paper into a policy brief, 1-page summary, or 5-page summary for a general audience, with factual review and a standalone HTML page for GitHub Pages.
claesbackman · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add claesbackman/AI-research-feedback --skill paper-versionAbout this skill
name: paper-version description: Convert a LaTeX research paper into a policy brief, 1-page summary, or 5-page summary for a general audience, with factual review and a standalone HTML page for GitHub Pages. user-invocable: true argument-hint: [brief|1page|5page] allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent disable-model-invocation: true
Paper Versions
Convert a LaTeX research paper project into an accessible audience-facing version, review it for accuracy, and produce a standalone HTML page.
Input
$ARGUMENTS[0]— Output format:brief,1page, or5page(required)
Format definitions
brief— A structured 2-page policy brief with fixed sections: The Question, What We Do, Key Findings, Policy Implications, Caveats. Formal but accessible. No jargon.1page— One flowing page of prose for a general audience. No section headers. Written like a short article. Leads with the main finding.5page— A five-page narrative summary with light structure (Background, What We Did, What We Found, Why It Matters, Limitations). Accessible to an educated non-specialist.
Instructions
Step 0 — Validate input
If $ARGUMENTS[0] is not one of brief, 1page, 5page, stop and tell the user: "Please specify a format: brief, 1page, or 5page."
Set FORMAT = the argument value.
Step 1 — Reader Agent
Launch an Agent (subagent_type: general-purpose) with this task:
You are reading a LaTeX research paper project. Your job is to extract the full content of the paper into a clean, structured plain-text representation that will be used by a writer agent.
Instructions:
- Find the main
.texfile in the current directory. It is usually the file that contains\documentclassor\begin{document}. Use Glob to search for**/*.texfiles, then identify the root file.- Read the root
.texfile. Wherever you find\input{...}or\include{...}commands, read those files too, recursively, until you have assembled the full paper text.- Strip LaTeX markup: remove commands like
\textbf{},\emph{},\cite{},\label{},\ref{},\footnote{}, equation environments, figure environments, table environments. Keep the text content. For tables, summarize the key numbers in prose form. For figures, note what the figure shows based on the caption.- Extract and clearly label these components:
- Title
- Authors
- Abstract (verbatim)
- Introduction (full text)
- Data/Empirical Setting (if present)
- Methods/Approach (condensed)
- Main Results — list every key quantitative finding, with exact numbers, units, and confidence intervals as stated in the paper. Be exhaustive here.
- Robustness/Heterogeneity (condensed)
- Conclusion
- Key claims made by the authors — list every causal or interpretive claim the authors make explicitly, noting the exact language they use (e.g., "we find that X causes Y" vs. "X is associated with Y")
- Extract figure information: scan the full
.texsource for\includegraphicscommands. For each one, record:
- The filename as specified (e.g.,
figures/fig1orfig_results)- The caption text from the nearest
\caption{}command- Which section of the paper the figure appears in List these under a Figures section in your output, formatted as:
FIGURE: [filename] | CAPTION: [caption text] | SECTION: [section name]- Identify the 1-2 figures that best illustrate the paper's main finding and mark them with
[KEY FIGURE].- Return the full extraction as structured markdown. Do not summarize or interpret — just extract.
Save the Reader Agent's output to output/paper_extraction.md. Create the output/ directory if it does not exist.
After the Reader Agent finishes, scan the project directory for image files that match the extracted figure filenames. Use Glob to search for **/*.png, **/*.jpg, and **/*.jpeg. For each figure listed as [KEY FIGURE] in paper_extraction.md, check whether a matching PNG or JPG file exists (try the filename with and without extension, and with common path prefixes like figures/, Figures/, fig/). Build a list of embeddable figures — those where a .png or .jpg file was found — and save it to output/figures_list.md in this format:
EMBEDDABLE: [relative path from project root] | CAPTION: [caption text]
NOT FOUND (PDF or missing): [filename] | CAPTION: [caption text]
If no PNG/JPG figures are found at all, note that in output/figures_list.md and continue — the HTML will be text-only.
Step 2 — Writer Agent
Launch an Agent (subagent_type: general-purpose) with this task, passing it the content of output/paper_extraction.md and the value of FORMAT:
Read the complete source ↗You are a science writer creating an accessible version of an economics research paper for a general audience.
Paper content: [paste full content of output/paper_extraction.md]
Output format requested: [FORMAT]
Format instructions:
For
brief— Write a structured policy brief. Use exactly these section headers:
- The Question — What problem does this paper address? (2-3 sentences)
- What We Do — How do the authors study it? Data, setting, method in plain language. (3-4 sentences)
- Key Findings — The main quantitative results. Report actual numbers. (4-6 bullet points, each 1-2 sentences)
- Policy Implications — What do these findings suggest for policy? Be concrete. (3-5 sentences)
- Caveats — Limitations the authors themselves acknowledge. (2-3 sentences) Total length: approximately 500-600 words.
For
1page— Write one page of flowing prose. No section headers. Open with the main finding stated plainly. Use accessible analogies where helpful. Do not use academic hedging or jargon. End with why it matters. Total length: approximately 350-400 words.For
5page— W