add-paper
Add a research paper to the maxpool research-papers collection. Use when the user provides an ArXiv URL, PDF link, or asks to add/summarize a research paper for the website. Handles paper fetching, insight extraction, HTML generation, and index updates.
When & Why to Use This Skill
This Claude skill automates the end-to-end workflow of integrating academic research into digital collections. It streamlines the process of fetching papers from ArXiv or PDF links, extracting critical insights and performance metrics, and generating structured, SEO-friendly HTML reports. By including ELI5 (Explain Like I'm 5) summaries and automated index updates, it transforms complex academic papers into accessible, well-organized knowledge assets.
Use Cases
- Automated Research Repository: Seamlessly add and format new ArXiv papers into a structured web-based research library with consistent styling.
- Insight & Metric Extraction: Automatically identify and highlight key findings, performance benchmarks (+/- percentages), and methodology from dense academic texts.
- Technical Content Marketing: Generate reader-friendly summaries and ELI5 explanations to make high-level AI/ML research accessible to non-expert stakeholders.
- Knowledge Base Management: Maintain an organized, searchable index of research papers with automated metadata extraction and descriptive summaries for better discoverability.
| name | add-paper |
|---|---|
| description | Add a research paper to the maxpool research-papers collection. Use when the user provides an ArXiv URL, PDF link, or asks to add/summarize a research paper for the website. Handles paper fetching, insight extraction, HTML generation, and index updates. |
| allowed-tools | WebFetch, Read, Write, Edit, Glob, Grep, Bash(ls:*), Bash(mkdir:*) |
Add Research Paper Skill
This skill automates adding research papers to the /research-papers/ directory following the established template patterns.
When to Use This Skill
Trigger this skill when the user:
- Provides an ArXiv URL (html, abs, or pdf format)
- Asks to "add a paper" or "create a research summary"
- Wants to include a paper in the research-papers collection
Input URL Handling
The user may provide URLs in different formats. Convert them to HTML format for best parsing:
| Input Format | Example | Convert To |
|---|---|---|
| ArXiv HTML | arxiv.org/html/2512.04123v1 |
Use as-is (preferred) |
| ArXiv Abstract | arxiv.org/abs/2512.04123v1 |
arxiv.org/html/2512.04123v1 |
| ArXiv PDF | arxiv.org/pdf/2512.04123v1.pdf |
arxiv.org/html/2512.04123v1 |
| AlphaXiv | alphaxiv.org/abs/2512.04123 |
Fetch directly |
Workflow
Step 1: Fetch and Parse Paper
- Use
WebFetchto retrieve the paper content from the HTML URL - Extract these key elements:
- Title: Full paper title
- Authors: Author names and affiliations
- Date: Publication/submission date
- Abstract: Paper abstract
- Key Sections: Introduction, methodology, results, conclusion
Step 2: Analyze and Extract Insights
From the paper content, identify:
- 3-5 Key Findings - The most important discoveries or contributions
- Performance Metrics - Specific percentages, improvements, benchmarks
- Use
<span class="performance-improvement">+24%</span>for improvements - Use
<span class="performance-decline">-15%</span>for declines - Use
<span class="metric">73%</span>for neutral metrics
- Use
- Methodology - How the research was conducted
- Benchmarks/Datasets - What was tested and where
- Figure URLs - Extract image URLs from the HTML for inclusion
Step 3: Extract Figure URLs and Determine Sizing
For ArXiv HTML pages, figures are typically at:
- Direct
<img>tags in the HTML content - ArXiv CDN paths
For AlphaXiv papers, use pattern:
https://paper-assets.alphaxiv.org/figures/[paper-id]/img-[N].jpeg
Image Sizing Guidelines
IMPORTANT: Paper figures vary greatly in size. Apply appropriate sizing based on content type:
| Figure Type | Recommended Width | Usage |
|---|---|---|
| Architecture diagrams | max-width: 100% |
Full width for complex diagrams |
| Most paper figures | max-width: 800px |
Default - bar charts, results, comparisons |
| Charts with legends | max-width: 750px |
Pie charts, distribution charts |
| Tables as images | max-width: 800px |
Comparison tables, results |
| Simple diagrams | max-width: 650px |
Flowcharts, concept illustrations |
| Very small figures | max-width: 500px |
Icons, simple symbols |
Apply sizing using inline style on the <img> tag:
IMPORTANT: Use width: 100%; max-width: Xpx; — not just max-width alone!
max-widthalone won't scale up small imageswidth: 100%makes the image fill its containermax-widththen caps it at a reasonable size
<!-- Full width for architecture diagrams -->
<div class="figure">
<img src="..." alt="..." style="width: 100%;">
<div class="figure-caption">Figure 1: System Architecture</div>
</div>
<!-- Default for most figures (RECOMMENDED) -->
<div class="figure">
<img src="..." alt="..." style="width: 100%; max-width: 800px;">
<div class="figure-caption">Figure 2: Performance Results</div>
</div>
<!-- Smaller figures -->
<div class="figure">
<img src="..." alt="..." style="width: 100%; max-width: 650px;">
<div class="figure-caption">Figure 3: Concept Diagram</div>
</div>
Rules of thumb:
- Academic paper figures are usually high-resolution → use 800px as default
- If the figure has lots of small text/labels → use 100% width
- Only constrain to 500-650px for genuinely small/simple diagrams
- When in doubt, use
max-width: 800px— too small is worse than too large - Always keep
max-width: 100%in the base CSS to prevent overflow
Step 4: Generate HTML File
- Read the template from
TEMPLATE.mdin this skill directory - Create file:
/research-papers/[topic]_report.html - Use descriptive filename (e.g.,
agent_memory_systems_report.html)
Required Sections:
1. Navigation header (copy from template)
2. Title with <br> for subtitle
3. Authors div with date
4. Executive Summary (.abstract box) - 2-3 paragraphs with metrics
5. ELI5 box (.eli5-box) - Simple analogy for non-experts
6. Key figures from the paper (.figure with .figure-caption)
7. Part-based content (Part 1:, Part 2:, etc.)
8. Key finding boxes (.key-finding) for important discoveries
9. Methodology boxes (.methodology-box) for methods
10. Tables for comparisons and benchmarks
11. Conclusion box (.conclusion-box) with summary
12. Source box (.source-box) with original paper link
13. Navigation footer (same as header)
Step 5: Update Index
Edit /research-papers/index.html to add a new table row:
<tr>
<td>
<a href="[filename].html" target="_blank" class="paper-link">
<strong>[Paper Title]</strong>
</a>
</td>
<td class="description">[150-200 word description with key metrics, methods, and improvements. Focus on specific numbers and practical implications.]</td>
</tr>
Add the new entry after the last <tr> in the <tbody>.
Step 6: Validate
Before completing, verify:
- All required sections present
- Figure URLs are valid and load
- Metrics highlighted with appropriate classes
- Navigation links are correct (
../index.html, etc.) - ELI5 explanation is genuinely simple
- Source box links to original paper
- Index.html entry added with description
Quality Guidelines
Content Standards
- Information Density: Pack maximum useful information per paragraph
- Specific Metrics: Use "24%" not "significant improvement"
- ELI5 Analogies: Use real-world comparisons anyone can understand
- Part Structure: Organize as "Part 1:", "Part 2:", etc.
- Key Findings: Highlight in dedicated boxes
- Honest Limitations: Include what the paper doesn't solve
Description for Index (150-200 words)
The index description should include:
- What the paper introduces (method/framework/analysis)
- Key metrics and improvements (specific percentages)
- Benchmarks or environments tested
- Main implications or breakthroughs
- Academic but accessible tone
File References
- Template: See
TEMPLATE.mdin this directory for complete HTML structure - Existing papers: Check
/research-papers/*.htmlfor style reference - Guidelines: See
/research-papers/CLAUDE.mdfor detailed documentation
Example Usage
User: "Add this paper: https://arxiv.org/html/2512.04123v1"
- Fetch the ArXiv HTML page
- Extract title, authors, abstract, key sections
- Identify 3-5 key findings with metrics
- Find figure URLs in the HTML
- Generate
/research-papers/[topic]_report.htmlusing template - Add entry to
/research-papers/index.html - Report completion with file path