EasyPaper Skill#

Generate structured academic papers from metadata using the EasyPaper multi-agent system via Python SDK.

Repository#

Source: https://github.com/PinkGranite/EasyPaper

Primary Reference Directory: plugins/easypaper/

This directory contains comprehensive guidance for OpenClaw agents:

• Commands: Workflow execution contracts in plugins/easypaper/commands/
• Skills: Domain-specific skills in plugins/easypaper/skills/
• Plugin Documentation: Setup and usage in plugins/easypaper/.claude-plugin/README.md

Installation#

Python Package#

Important: Install EasyPaper in an isolated environment (recommended for dependency management).

Using venv:

bash

python -m venv easypaper-env
source easypaper-env/bin/activate  # On Windows: easypaper-env\Scripts\activate
pip install easypaper

Using conda:

bash

conda create -n easypaper python=3.11
conda activate easypaper
pip install easypaper

Direct install (not recommended):

bash

pip install easypaper

LaTeX Toolchain#

EasyPaper requires LaTeX toolchain ( pdflatex + bibtex) for PDF compilation. Install based on your system:

macOS:

bash

# Using Homebrew (recommended)
brew install --cask mactex

# Or minimal installation
brew install basictex
sudo tlmgr update --self
sudo tlmgr install collection-basic collection-latex collection-bibtexextra

Linux (Ubuntu/Debian):

bash

sudo apt-get update
sudo apt-get install texlive-latex-base texlive-bibtex-extra texlive-latex-extra

Linux (Fedora/RHEL):

bash

sudo dnf install texlive-scheme-basic texlive-bibtex texlive-latex

Windows:

• Download and install MiKTeX (full installer recommended)
• Or use TeX Live
• Ensure pdflatex and bibtex are in your PATH

Poppler (for PDF-to-image conversion)#

macOS:

bash

brew install poppler

Linux (Ubuntu/Debian):

bash

sudo apt-get install poppler-utils

Linux (Fedora/RHEL):

bash

sudo dnf install poppler-utils

Windows:

• Download from Poppler for Windows
• Extract and add bin directory to PATH
• Or use conda: conda install -c conda-forge poppler

Quick Start#

Recommended workflow: Prepare a metadata.json (see examples/meta.json), parse it as PaperGenerationRequest, then run with to_metadata() + to_generate_options().

Typesetter behavior (SDK + Server): PDF compilation prefers in-process Typesetter when available (SDK self-contained). If no local peer is available, EasyPaper falls back to the HTTP Typesetter endpoint ( AGENTSYS_SELF_URL).

Load from file and generate#

python

import asyncio
from pathlib import Path
from easypaper import EasyPaper, PaperGenerationRequest

async def main():
    ep = EasyPaper(config_path=str(Path("configs/dev.yaml").resolve()))

    request = PaperGenerationRequest.model_validate_json_file("metadata.json")
    metadata = request.to_metadata()
    options = request.to_generate_options()

    result = await ep.generate(metadata, **options)
    print(f"Status: {result.status}, Words: {result.total_word_count}")

asyncio.run(main())

Inline metadata#

python

import asyncio
from easypaper import EasyPaper, PaperMetaData

async def main():
    ep = EasyPaper(config_path="configs/dev.yaml")

    metadata = PaperMetaData(
        title="My Paper Title",
        idea_hypothesis="...",
        method="...",
        data="...",
        experiments="...",
        references=["@article{...}"],
    )

    result = await ep.generate(metadata)
    print(f"Status: {result.status}, Words: {result.total_word_count}")

asyncio.run(main())

Key Reference Files#

When working with EasyPaper, refer to these files in the repository:

Commands (Workflow Execution)#

• plugins/easypaper/commands/easypaper.md - End-to-end metadata workflow contract
• plugins/easypaper/commands/paper-from-metadata.md - Direct metadata-to-paper generation
• plugins/easypaper/commands/paper-section.md - Single section generation

Skills (Domain Guidance)#

• plugins/easypaper/skills/setup-environment/SKILL.md - Automatic environment setup (Python, LaTeX)
• plugins/easypaper/skills/paper-from-metadata/SKILL.md - Full paper generation workflow
• plugins/easypaper/skills/venue-selection/SKILL.md - Venue-specific formatting (NeurIPS, ICML, ICLR, ACL, AAAI, COLM, Nature)
• plugins/easypaper/skills/academic-writing-rules/SKILL.md - Academic writing and LaTeX conventions

Configuration and Examples#

• configs/example.yaml - Complete configuration template
• economist_example/metadata.json - Full metadata example with all fields
• user_case/ - Standalone usage example
• README.md - Main documentation
• AGENTS.md - Repository-level agent instructions

PaperMetaData Fields#

Required:

• title, idea_hypothesis, method, data, experiments, references

Optional:

• style_guide (venue name), target_pages, template_path, figures, tables, code_repository, export_prompt_traces

See examples/meta.json and economist_example/metadata.json for full examples. Treat examples/meta.json as a full PaperGenerationRequest sample: use request = PaperGenerationRequest.model_validate_json_file(...), then request.to_metadata() and request.to_generate_options() for SDK generation.

Final PDF Selection#

When review loop is enabled, multiple iteration PDFs can exist. Always report the final artifact using this priority:

1. result.pdf_path (authoritative final output)
2. Under result.output_path: iteration_*_final/**/*.pdf
3. Under result.output_path: latest iteration_* directory PDF
4. result.output_path/paper.pdf (last fallback)

If no PDF is found, report that final PDF is unavailable and include recent compile errors.

Streaming Generation#

python

from easypaper import EasyPaper, PaperMetaData, EventType

async for event in ep.generate_stream(metadata):
    if event.event_type == EventType.PHASE_START:
        print(f"▶ [{event.phase}] {event.message}")
    elif event.event_type == EventType.COMPLETE:
        result = event.data["result"]
        print(f"Done! {result['total_word_count']} words")

When to Use This Skill#

Use this skill when:

• User wants to generate academic papers programmatically
• User needs to understand EasyPaper SDK usage
• User asks about paper generation workflows
• User needs venue-specific formatting guidance

For detailed workflows and execution contracts, refer to files in plugins/easypaper/ directory.