Paper Synthesizer

VerifiedCaution

Subagent that fetches and synthesizes a single research paper. It downloads the PDF, extracts key details (problem, method, results, limitations), and writes a structured staging file for the main agent. Useful when processing multiple papers for a literature synthesis task.

Sby Skills Guide Bot
Data & AIIntermediate
3/1/2026
Claude Code
#paper-synthesis#pdf-extraction#arxiv#literature-review#research

Recommended for

Automated summary

A subagent that fetches a single paper from its URL, reads the PDF, and writes a structured 600–1000 word analysis to a staging file.

Strengths

  • Standardized, predictable output (YAML metadata, problem, method, results, limitations) that the main agent can consume directly
  • Detailed extraction rules: equations with variable definitions, key result table rows, concrete numbers, and training details
  • Deliberately narrow tool scope (attach_url_files and exec_command) that prevents stray or redundant calls
  • Returns only the staging file path, keeping the main agent's context small

Limitations

  • Relies on specific tools (attach_url_files, exec_command) and the $HOME/.ata/knowledge-base layout, so it is not portable outside that environment
  • Built to be spawned by $paper-synthesis and awkward to run standalone without the orchestrator
  • Handles one paper at a time and does not recover from inaccessible or non-text PDFs
When to use it

Use it when one specific paper must be read closely and summarized in a structured form to feed a larger synthesis.

When not to use it

Avoid it for multi-paper literature search, full page-by-page reading, or outside an agent that provides attach_url_files and exec_command.

Security analysis

Caution
Quality score86/100

The skill is not destructive or exfiltrating, and its file-writing and network-fetching actions serve the stated synthesis workflow. However, it executes shell commands and processes untrusted paper content, and it does not explicitly sanitize the identifier used in the staging filename, so it warrants caution.

Findings
  • •Uses `exec_command` to create directories and write files under `$HOME/.ata/knowledge-base/staging`, a legitimate but filesystem-modifying operation.
  • •Fetches arbitrary paper URLs via `attach_url_files`, so the subagent processes untrusted external documents and may be exposed to prompt injection embedded in PDFs.
  • •The output filename includes `<identifier>` directly in an unquoted shell path; a malicious or malformed identifier containing shell metacharacters or path traversal sequences could affect the write target or command execution.
How this analysis is made

Examples

Synthesize one arXiv paper
Use $paper-synthesis to fetch https://arxiv.org/abs/1706.03762 and extract a structured analysis of the Transformer paper into a staging file.
Extract method details
Read this paper URL and give me its core method with the key equations and hyperparameters, saving the analysis as a staging markdown file.

name: paper-synthesizer description: "Subagent skill for paper synthesis. Spawned by $paper-synthesis to fetch and extract information from a single paper." metadata: short-description: Subagent skill for paper-synthesis

Paper Synthesizer

You are a synthesis subagent. Your job: fetch ONE paper via attach_url_files, read it, and extract all important information.

Instructions

  1. Call attach_url_files with the paper URL given to you.
  2. Read the attached PDF.
  3. Extract all important information from the paper (see What to Extract below).
  4. Write a staging file via exec_command (the staging directory is always used for temporary data transfer, regardless of whether KB persistence is enabled). Use the absolute path to avoid sandbox denials:
    mkdir -p $HOME/.ata/knowledge-base/staging && cat <<'CARD_EOF' > $HOME/.ata/knowledge-base/staging/paper-<identifier>.md
    ---
    title: "<paper title>"
    authors: "<author list>"
    identifier: "<arXiv ID, DOI, or URL>"
    year: <year>
    venue: "<venue if known>"
    ---
    <your full extracted analysis>
    CARD_EOF
    
    Use the arXiv ID (e.g., 1706.03762), DOI, or a slug from the title as <identifier>.
  5. Return only the staging file path (e.g., $HOME/.ata/knowledge-base/staging/paper-1706.03762.md). Do NOT return the full analysis text — the main agent will read it from disk.

Do NOT call spawn_agent, present_reading_view, cross-paper-report, list_mcp_resources, pwd, or ls. Your tools are attach_url_files and exec_command (for writing the staging file only).

What to Extract

Write a focused analysis that covers the paper's key contributions clearly. Target 600-1000 words total — prioritize depth on the core method over exhaustive coverage of every detail.

Structure your output with these sections:

  1. Metadata (at the top, in the YAML frontmatter): title, authors, year, venue, arXiv ID or DOI
  2. Problem & Motivation (2-3 sentences): what gap, why it matters
  3. Core Method (main body — spend most of your words here): what they do, key mechanisms, architecture choices and why. Include specific numbers (dimensions, layer counts, etc.) inline
  4. Results (1 paragraph): headline numbers, key baselines, what the gaps tell us
  5. Limitations & Connections (2-4 sentences): what doesn't work, how this relates to prior work

Extraction Quality Guidelines

  • Equations: Include key equations with variable definitions. Write each equation on its own line. The main agent needs them to build intuitive explanations.
  • Tables: For key results tables, extract the most important rows/columns as structured data. Include baseline names and numbers — the main agent needs specific comparisons.
  • Figures: Do not reference figure numbers (the user can't see them). Instead, describe what key figures show: "The architecture consists of [encoder → latent space → decoder], where..."
  • Specific numbers: Always include: model parameter count, training data size, key benchmark scores, inference speed if reported, and any ablation results that reveal which components matter.
  • Training details: Capture training stages, optimizer, learning rate, batch size, GPU hours if reported. These are essential for the main agent's Details blocks.

Include concrete details but don't pad with boilerplate. Every sentence should carry information. The main agent will reshape this for the user — your job is to provide rich, accurate source material efficiently.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/paper-synthesizer-mm78nof6/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/paper-synthesizer-mm78nof6' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/paper-synthesizer-mm78nof6/download' --output '.skill-downloads/paper-synthesizer-mm78nof6/SKILL.md.part' && mv '.skill-downloads/paper-synthesizer-mm78nof6/SKILL.md.part' '.skill-downloads/paper-synthesizer-mm78nof6/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/paper-synthesizer-mm78nof6/SKILL.md' && test -s '.skill-downloads/paper-synthesizer-mm78nof6/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/paper-synthesizer' && cp -R '.skill-downloads/paper-synthesizer-mm78nof6' '.claude/skills/paper-synthesizer'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/paper-synthesizer-mm78nof6'

openskills read 'paper-synthesizer-mm78nof6'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/paper-synthesizer-mm78nof6/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills