lingzhi227/agent-research-skills

paper-assembly

Orchestrate the full paper pipeline end-to-end.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/lingzhi227/agent-research-skills --skill paper-assembly

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Paper Assembly

Orchestrate the entire paper pipeline end-to-end with state management and checkpointing.

Input

  • $0 — Paper project directory or paper plan

References

  • Orchestration patterns and state management: ~/.claude/skills/paper-assembly/references/orchestration-patterns.md

Scripts

Check pipeline completeness

bash
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --output checkpoint.json
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --verbose

Scans paper directory, checks 9 pipeline phases, reports missing artifacts, suggests next steps.

Workflow

Step 1: Assess Current State

  1. Scan the paper directory for existing artifacts
  2. Identify which phases are complete vs pending
  3. Build a dependency graph of remaining work

Step 2: Execute Pipeline Phases

Run phases in dependency order:

PhaseSkillInputOutput
1. Literatureliterature-search, literature-reviewTopicKnowledge base, BibTeX
2. Planningresearch-planningKnowledge basePaper structure, task list
3. Codeexperiment-codePlanTraining/eval pipeline
4. Experimentsexperiment-designCodeResults JSON/CSV
5. Figuresfigure-generationResultsPNG figures
6. Tablestable-generationResultsLaTeX tables
7. Writingpaper-writing-sectionAll abovemain.tex sections
8. Citationscitation-managementDraftreferences.bib
9. Formattinglatex-formattingDraftFormatted LaTeX
10. Compilationpaper-compilationAllPDF
11. Reviewself-reviewPDFReview scores

Step 3: State Propagation

After each phase completes:

  1. Save output artifacts to the paper directory
  2. Propagate results to downstream phases
  3. Update the progress checkpoint file

Step 4: Quality Gates

Before proceeding to the next phase:

  • Verify all required outputs exist
  • Check for consistency (e.g., all cited keys in .bib)
  • Validate figures/tables match experimental results

Step 5: Final Assembly

  1. Merge all sections into main.tex
  2. Verify all \includegraphics files exist
  3. Verify all \cite keys exist in .bib
  4. Compile to PDF
  5. Run self-review for quality check

Orchestration Patterns

Sequential Pipeline (AI-Scientist)

generate_ideas → experiments → writeup → review

Multi-Agent State Broadcasting (AgentLaboratory)

python
# Propagate results to all downstream agents
set_agent_attr("dataset_code", code)
set_agent_attr("results", results_json)

Copilot Mode (AgentLaboratory)

Human can intervene at any phase boundary for review/correction.

Checkpoint Format

json
{
  "project": "paper-name",
  "phases_completed": ["literature", "planning", "code"],
  "current_phase": "experiments",
  "artifacts": {
    "literature": "knowledge_base.json",
    "plan": "research_plan.json",
    "code": "experiments/",
    "results": null
  },
  "last_updated": "2024-01-15T10:30:00Z"
}

Rules

  • Never skip phases — each depends on previous outputs
  • Save checkpoints after every phase completion
  • Human review is recommended at phase boundaries
  • All numbers in the paper must trace to actual experiment logs
  • Re-run downstream phases if upstream changes

Related Skills

Related by task

from this repository

More skills

All skills