跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

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 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add claesbackman/AI-research-feedback --skill paper-version

技能说明


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, or 5page (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:

  1. Find the main .tex file in the current directory. It is usually the file that contains \documentclass or \begin{document}. Use Glob to search for **/*.tex files, then identify the root file.
  2. Read the root .tex file. Wherever you find \input{...} or \include{...} commands, read those files too, recursively, until you have assembled the full paper text.
  3. 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.
  4. 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")
  5. Extract figure information: scan the full .tex source for \includegraphics commands. For each one, record:
    • The filename as specified (e.g., figures/fig1 or fig_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]
  6. Identify the 1-2 figures that best illustrate the paper's main finding and mark them with [KEY FIGURE].
  7. 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:

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

阅读完整来源 ↗