@wentorai/research-plugins 1.1.0 → 1.2.0

package/skills/tools/ocr-translate/math-equation-renderer/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: math-equation-renderer
+description: "Render LaTeX math equations as publication-ready PNG and SVG images"
+metadata:
+  openclaw:
+    emoji: "🔢"
+    category: "tools"
+    subcategory: "ocr-translate"
+    keywords: ["latex math", "equation rendering", "math images", "formula to png", "math typesetting", "tex rendering"]
+    source: "https://clawhub.ai/huaruoji/math-images"
+---
+
+# Math Equation Renderer — LaTeX to Image
+
+## Overview
+
+Rendering LaTeX math equations as standalone images (PNG, SVG, PDF) is essential for presentations, social media, documentation, and any context where native LaTeX rendering is unavailable. This guide covers multiple methods: command-line tools, Python libraries, and web APIs. Choose based on your workflow: batch processing favors CLI tools, while one-off equations work well with web APIs.
+
+## Method 1: TeX + dvipng (Command Line)
+
+The classic approach using a minimal LaTeX document:
+
+```bash
+# Install prerequisites
+# macOS: brew install --cask mactex
+# Ubuntu: sudo apt install texlive-latex-base dvipng
+
+# Create a minimal .tex file
+cat > equation.tex << 'EOF'
+\documentclass[border=2pt]{standalone}
+\usepackage{amsmath,amssymb}
+\begin{document}
+$\displaystyle E = mc^2$
+\end{document}
+EOF
+
+# Compile to DVI then PNG
+latex equation.tex
+dvipng -D 300 -bg Transparent -T tight equation.dvi -o equation.png
+
+# Or compile directly to PDF
+pdflatex equation.tex
+```
+
+### Batch Rendering Script
+
+```bash
+#!/bin/bash
+# Render multiple equations from a text file (one per line)
+INPUT="equations.txt"
+OUTPUT_DIR="./rendered"
+DPI=300
+mkdir -p "$OUTPUT_DIR"
+
+i=1
+while IFS= read -r eq; do
+    cat > "/tmp/eq_${i}.tex" << EOF
+\documentclass[border=2pt]{standalone}
+\usepackage{amsmath,amssymb}
+\begin{document}
+\$\displaystyle ${eq}\$
+\end{document}
+EOF
+    (cd /tmp && latex -interaction=batchmode "eq_${i}.tex" && \
+     dvipng -D "$DPI" -bg Transparent -T tight "eq_${i}.dvi" \
+       -o "${OLDPWD}/${OUTPUT_DIR}/eq_${i}.png") 2>/dev/null
+    echo "Rendered equation $i: $eq"
+    ((i++))
+done < "$INPUT"
+echo "Done. $((i-1)) equations rendered to $OUTPUT_DIR/"
+```
+
+## Method 2: matplotlib (Python)
+
+```python
+import matplotlib.pyplot as plt
+import matplotlib
+matplotlib.use('Agg')  # Non-interactive backend
+
+def render_equation(latex_str: str, output_path: str, dpi: int = 300,
+                    fontsize: int = 20, color: str = "black"):
+    """Render a LaTeX equation to PNG."""
+    fig, ax = plt.subplots(figsize=(0.1, 0.1))
+    ax.axis('off')
+    text = ax.text(0.5, 0.5, f"${latex_str}$",
+                   fontsize=fontsize, color=color,
+                   ha='center', va='center',
+                   transform=ax.transAxes)
+
+    # Auto-size the figure to fit the equation
+    fig.savefig(output_path, dpi=dpi, bbox_inches='tight',
+                pad_inches=0.1, transparent=True)
+    plt.close(fig)
+    print(f"Saved: {output_path}")
+
+# Usage
+render_equation(r"\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}",
+                "maxwell.png")
+render_equation(r"\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}",
+                "gaussian.png")
+```
+
+### Batch Rendering with matplotlib
+
+```python
+equations = {
+    "schrodinger": r"i\hbar\frac{\partial}{\partial t}\Psi = \hat{H}\Psi",
+    "einstein":    r"R_{\mu\nu} - \frac{1}{2}Rg_{\mu\nu} = \frac{8\pi G}{c^4}T_{\mu\nu}",
+    "euler":       r"e^{i\pi} + 1 = 0",
+    "bayes":       r"P(A|B) = \frac{P(B|A)\,P(A)}{P(B)}",
+    "fourier":     r"\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x)\,e^{-2\pi ix\xi}\,dx",
+}
+
+for name, eq in equations.items():
+    render_equation(eq, f"equations/{name}.png", dpi=300, fontsize=24)
+```
+
+## Method 3: sympy (Python — Symbolic Math)
+
+```python
+from sympy import *
+from sympy.printing.preview import preview
+
+x, y, z = symbols('x y z')
+f = Function('f')
+
+# Render symbolic expression
+expr = Integral(exp(-x**2), (x, -oo, oo))
+preview(expr, viewer='file', filename='integral.png',
+        dvioptions=['-D', '300', '-bg', 'Transparent'])
+
+# Render matrix
+M = Matrix([[1, x], [y, x*y]])
+preview(M, viewer='file', filename='matrix.png',
+        dvioptions=['-D', '300', '-bg', 'Transparent'])
+```
+
+## Method 4: Web APIs (No Local TeX Required)
+
+### Codecogs API
+
+```bash
+# URL-encoded LaTeX → PNG
+curl -o equation.png \
+  "https://latex.codecogs.com/png.image?\dpi{300}\bg{transparent}E=mc^2"
+
+# SVG output
+curl -o equation.svg \
+  "https://latex.codecogs.com/svg.image?E=mc^2"
+```
+
+### MathJax (HTML to Image)
+
+```python
+# Using Playwright to render MathJax equations
+from playwright.sync_api import sync_playwright
+
+def mathjax_to_png(latex: str, output: str):
+    html = f"""<!DOCTYPE html>
+    <html><head>
+    <script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js"></script>
+    </head><body>
+    <div id="eq">$$\\displaystyle {latex}$$</div>
+    </body></html>"""
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page()
+        page.set_content(html)
+        page.wait_for_function("() => window.MathJax && MathJax.startup.promise")
+        element = page.query_selector("#eq")
+        element.screenshot(path=output)
+        browser.close()
+```
+
+## Output Format Comparison
+
+| Format | Best For | Scalable? | Transparent BG? |
+|--------|----------|-----------|-----------------|
+| PNG | Presentations, docs, web | No (raster) | Yes (with `-bg Transparent`) |
+| SVG | Web, scalable contexts | Yes (vector) | Yes |
+| PDF | LaTeX inclusion, print | Yes (vector) | Yes |
+| EPS | Legacy LaTeX workflows | Yes (vector) | No |
+
+## Tips
+
+- **DPI**: Use 300 for print, 150 for screen, 96 for web thumbnails
+- **Font consistency**: Match the equation font to your document's body font
+- **Dark mode**: Render with white text color for dark backgrounds: `color="white"`
+- **Accessibility**: Always provide alt-text describing the equation when embedding images
+- **Version control**: Store the LaTeX source alongside rendered images for reproducibility
+
+## References
+
+- [dvipng Documentation](https://ctan.org/pkg/dvipng)
+- [matplotlib mathtext](https://matplotlib.org/stable/gallery/text_labels_and_annotations/mathtext_examples.html)
+- [CodeCogs Equation Editor](https://latex.codecogs.com/)
+- [MathJax Documentation](https://docs.mathjax.org/)

package/skills/tools/ocr-translate/pdf-math-translate-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Translate scientific PDFs with preserved math formatting via PDFMa
 metadata:
   openclaw:
     emoji: "📄"
-    category: tools
-    subcategory: ocr-translate
+    category: "tools"
+    subcategory: "ocr-translate"
     keywords: ["pdf-translation", "math-formatting", "scientific-papers", "multilingual", "latex-preservation"]
     source: "https://github.com/Byaidu/PDFMathTranslate"
 ---

package/skills/tools/ocr-translate/zotero-pdf-translate-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Guide to Zotero PDF Translate for multilingual PDF and annotation
 metadata:
   openclaw:
     emoji: "🌐"
-    category: tools
-    subcategory: ocr-translate
+    category: "tools"
+    subcategory: "ocr-translate"
     keywords: ["zotero", "pdf-translate", "multilingual", "annotation", "academic-translation"]
     source: "https://github.com/windingwind/zotero-pdf-translate"
 ---

package/skills/tools/ocr-translate/zotero-pdf2zh-guide/SKILL.md

@@ -6,8 +6,8 @@ author: wentor-community
 source: https://github.com/guaguastandup/zotero-pdf2zh
 metadata:
   openclaw:
-    category: tools
-    subcategory: ocr-translate
+    category: "tools"
+    subcategory: "ocr-translate"
     keywords:
       - pdf-translation
       - zotero-plugin

package/skills/writing/citation/academic-citation-manager-guide/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: academic-citation-manager-guide
+description: "Comparison and workflow guide for academic citation management tools"
+metadata:
+  openclaw:
+    emoji: "📎"
+    category: "writing"
+    subcategory: "citation"
+    keywords: ["citation management", "reference manager", "zotero", "mendeley", "bibliography", "bibtex"]
+    source: "https://clawhub.com/YouStudyeveryday/academic-citation-manager"
+---
+
+# Academic Citation Management Guide
+
+## Overview
+
+Citation managers are essential tools for collecting, organizing, annotating, and citing academic references. This guide compares the major options (Zotero, Mendeley, EndNote, JabRef, Paperpile), covers core workflows, and provides best practices for building and maintaining a well-organized reference library.
+
+## Tool Comparison
+
+| Feature | Zotero | Mendeley | EndNote | JabRef | Paperpile |
+|---------|--------|----------|---------|--------|-----------|
+| **Price** | Free (open source) | Free (Elsevier) | $250+ | Free (open source) | $3/mo (students) |
+| **Storage** | 300 MB free, $20/yr for 2GB | 2 GB free | Unlimited (desktop) | Local files | 10 GB |
+| **PDF Management** | Yes + annotations | Yes + annotations | Yes | Basic | Yes |
+| **Browser Extension** | Excellent (Connector) | Good (Importer) | Average | Manual | Google Docs native |
+| **Word Plugin** | Word + LibreOffice | Word | Word | — | Google Docs + Word |
+| **LaTeX/BibTeX** | Export + Better BibTeX plugin | Export | Export | Native BibTeX editor | Export |
+| **Collaboration** | Group libraries (free) | Teams | Share libraries | Git-friendly files | Shared folders |
+| **Open Source** | Yes (GPL) | No | No | Yes (MIT) | No |
+| **Offline Use** | Full offline | Full offline | Full offline | Full offline | Limited |
+
+### Recommendation by Workflow
+
+| If You... | Use |
+|-----------|-----|
+| Write in LaTeX primarily | **JabRef** (native BibTeX) or **Zotero + Better BibTeX** |
+| Write in Word/LibreOffice | **Zotero** (best free plugin) |
+| Write in Google Docs | **Paperpile** (native integration) |
+| Need Elsevier integration | **Mendeley** (same company) |
+| Need institutional license | **EndNote** (common in universities) |
+| Want maximum flexibility | **Zotero** (open source, 600+ plugins) |
+
+## Core Workflow
+
+### 1. Collecting References
+
+**Browser Extension** (Zotero Connector example):
+1. Install Zotero Connector for Chrome/Firefox
+2. Browse to any paper page (journal, arXiv, Google Scholar)
+3. Click the Zotero icon → metadata + PDF saved automatically
+4. Works on: journal websites, arXiv, PubMed, Google Scholar, Amazon (books)
+
+**Import from DOI**:
+```
+Zotero: "Add Item(s) by Identifier" → paste DOI → auto-import
+Mendeley: "Add" → "Import DOI" → paste
+JabRef: "New Entry" → "ID-based entry generator" → paste DOI
+```
+
+**Import from BibTeX**:
+```bibtex
+% Save as references.bib, then import
+@article{vaswani2017attention,
+  title={Attention is all you need},
+  author={Vaswani, Ashish and others},
+  journal={NeurIPS},
+  year={2017}
+}
+```
+
+**Batch Import from Google Scholar**:
+```
+1. Search Google Scholar for your topic
+2. Select papers (checkbox) → Export → BibTeX
+3. Import .bib file into your citation manager
+4. Merge duplicates
+```
+
+### 2. Organizing References
+
+**Folder/Collection Structure** (recommended):
+
+```
+My Library/
+├── By Project/
+│   ├── Dissertation/
+│   │   ├── Chapter 1 - Introduction/
+│   │   ├── Chapter 2 - Literature Review/
+│   │   └── Chapter 3 - Methods/
+│   └── ICML 2026 Paper/
+├── By Topic/
+│   ├── Attention Mechanisms/
+│   ├── Retrieval-Augmented Generation/
+│   └── Code Generation/
+└── Reading Queue/
+    ├── To Read/
+    ├── In Progress/
+    └── Read + Annotated/
+```
+
+**Tagging Strategy**:
+```
+Tags by reading status: #to-read, #reading, #done
+Tags by relevance:      #core, #supporting, #background
+Tags by content:        #methodology, #dataset, #benchmark, #survey
+Tags by quality:        #seminal, #highly-cited, #controversial
+```
+
+### 3. Annotating and Note-Taking
+
+```markdown
+## Per-Paper Note Template
+
+### Quick Reference
+- **One-line summary**: [What this paper does in one sentence]
+- **Key contribution**: [The novel idea]
+- **Method**: [Technique used]
+- **Dataset**: [What data they use]
+- **Result**: [Main quantitative finding]
+
+### Detailed Notes
+- Strengths: [What's convincing]
+- Weaknesses: [What's questionable]
+- Relevance to my work: [How does this connect?]
+- Follow-up: [What to read next based on this paper]
+```
+
+### 4. Citing in Documents
+
+**In Word/LibreOffice** (Zotero):
+1. Place cursor where citation goes
+2. Zotero toolbar → "Add Citation"
+3. Search by author, title, or year
+4. Select citation → insert
+5. At end: "Add Bibliography" to generate reference list
+
+**In LaTeX** (Better BibTeX for Zotero):
+```bash
+# Install Better BibTeX plugin for Zotero
+# Set up auto-export:
+# Zotero → File → Export Library → Better BibTeX → Keep updated
+
+# In your .tex file:
+\bibliography{exported_library}
+\bibliographystyle{apalike}
+
+# Cite: \cite{vaswani2017attention}
+# Textual: \citet{vaswani2017attention} → Vaswani et al. (2017)
+# Parenthetical: \citep{vaswani2017attention} → (Vaswani et al., 2017)
+```
+
+### 5. Maintaining Your Library
+
+```markdown
+## Monthly Maintenance Checklist
+
+□ Merge duplicate entries (Zotero: right-click → Merge)
+□ Fix incomplete metadata (missing year, venue, DOI)
+□ Update "In Press" papers to final published versions
+□ Clean up tags (remove unused, consolidate synonyms)
+□ Back up library (export to BibTeX or Zotero Backup)
+□ Check for retracted papers (Retraction Watch database)
+```
+
+## Citation Style Quick Reference
+
+| Style | Disciplines | In-Text | Bibliography |
+|-------|------------|---------|-------------|
+| **APA 7th** | Psychology, Social Sciences | (Author, Year) | Author, A. A. (Year). Title. *Journal*, *Vol*(Issue), pages. DOI |
+| **IEEE** | Engineering, CS | [1] | [1] A. Author, "Title," *Journal*, vol. X, pp. Y-Z, Year. |
+| **Chicago Author-Date** | Humanities, Social Sciences | (Author Year) | Author, First. Year. *Title*. Place: Publisher. |
+| **Harvard** | Business, Social Sciences | (Author Year) | Author, F. (Year) 'Title', *Journal*, Vol(Issue), pp. X-Y. |
+| **Vancouver** | Biomedical, Medicine | (1) | 1. Author AB. Title. Journal. Year;Vol(Issue):pages. |
+| **MLA 9th** | Humanities, Literature | (Author Page) | Author. "Title." *Journal*, vol. X, no. Y, Year, pp. Z. |
+
+## References
+
+- [Zotero Documentation](https://www.zotero.org/support/)
+- [Better BibTeX for Zotero](https://retorque.re/zotero-better-bibtex/)
+- [JabRef Documentation](https://docs.jabref.org/)
+- [Citation Style Language](https://citationstyles.org/)

package/skills/writing/citation/citation-assistant-skill/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: citation-assistant-skill
+description: "Claude Code skill for citation workflow via Semantic Scholar"
+metadata:
+  openclaw:
+    emoji: "📎"
+    category: "writing"
+    subcategory: "citation"
+    keywords: ["citation assistant", "Semantic Scholar", "Claude Code skill", "reference lookup", "academic citation"]
+    source: "https://github.com/ZhangNy301/citation-assistant"
+---
+
+# Citation Assistant Skill Guide
+
+## Overview
+
+Citation Assistant is a Claude Code skill that integrates Semantic Scholar API into the coding workflow for instant paper lookup, citation formatting, and reference management. Search for papers by title or keyword, get formatted BibTeX entries, find related works, and insert citations — all without leaving the terminal. Designed for researchers writing papers in LaTeX or Markdown.
+
+## Installation
+
+```bash
+# Add as Claude Code skill
+# Copy SKILL.md to your Claude Code skills directory
+# Or install via OpenClaw:
+openclaw skills install citation-assistant
+```
+
+## Core Features
+
+### Paper Search
+
+```python
+import requests
+
+S2_API = "https://api.semanticscholar.org/graph/v1"
+
+def search_papers(query, limit=5):
+    """Search Semantic Scholar for papers."""
+    resp = requests.get(
+        f"{S2_API}/paper/search",
+        params={
+            "query": query,
+            "limit": limit,
+            "fields": "title,authors,year,citationCount,"
+                      "externalIds,abstract,venue",
+        },
+    )
+    return resp.json().get("data", [])
+
+papers = search_papers("attention mechanism transformer")
+for p in papers:
+    authors = ", ".join(a["name"] for a in p["authors"][:3])
+    print(f"[{p['year']}] {p['title']}")
+    print(f"  {authors} — Citations: {p['citationCount']}")
+    print(f"  DOI: {p.get('externalIds', {}).get('DOI', 'N/A')}")
+```
+
+### BibTeX Generation
+
+```python
+def get_bibtex(paper_id):
+    """Get BibTeX for a Semantic Scholar paper."""
+    resp = requests.get(
+        f"{S2_API}/paper/{paper_id}",
+        params={
+            "fields": "title,authors,year,venue,externalIds,"
+                      "journal,publicationTypes",
+        },
+    )
+    paper = resp.json()
+
+    # Generate citation key
+    first_author = paper["authors"][0]["name"].split()[-1].lower()
+    key = f"{first_author}{paper['year']}"
+
+    # Build BibTeX
+    authors_str = " and ".join(a["name"] for a in paper["authors"])
+    doi = paper.get("externalIds", {}).get("DOI", "")
+
+    bibtex = f"""@article{{{key},
+  title = {{{paper['title']}}},
+  author = {{{authors_str}}},
+  year = {{{paper['year']}}},
+  journal = {{{paper.get('venue', '')}}},
+  doi = {{{doi}}},
+}}"""
+    return bibtex
+
+# Example
+bibtex = get_bibtex("204e3073870fae3d05bcbc2f6a8e263d9b72e776")
+print(bibtex)
+```
+
+### Citation Context
+
+```python
+def get_citation_context(paper_id, limit=10):
+    """Get papers that cite this work with context."""
+    resp = requests.get(
+        f"{S2_API}/paper/{paper_id}/citations",
+        params={
+            "fields": "title,year,contexts,intents",
+            "limit": limit,
+        },
+    )
+    citations = resp.json().get("data", [])
+
+    for cit in citations:
+        paper = cit["citingPaper"]
+        print(f"\n{paper['title']} ({paper.get('year', '?')})")
+        for ctx in cit.get("contexts", [])[:2]:
+            print(f"  Context: ...{ctx[:100]}...")
+        print(f"  Intent: {cit.get('intents', ['unknown'])}")
+
+get_citation_context("204e3073870fae3d05bcbc2f6a8e263d9b72e776")
+```
+
+### Related Paper Discovery
+
+```python
+def find_related(paper_id, limit=10):
+    """Find papers related to a given paper."""
+    resp = requests.get(
+        f"{S2_API}/paper/{paper_id}/recommendations",
+        params={
+            "fields": "title,authors,year,citationCount",
+            "limit": limit,
+        },
+    )
+    return resp.json().get("recommendedPapers", [])
+
+related = find_related("204e3073870fae3d05bcbc2f6a8e263d9b72e776")
+for p in related:
+    print(f"[{p['year']}] {p['title']} ({p['citationCount']} cites)")
+```
+
+## Workflow Integration
+
+```markdown
+### LaTeX Workflow
+1. Search: "Find papers on transformer efficiency"
+2. Select relevant papers from results
+3. Generate BibTeX entries → append to references.bib
+4. Insert \cite{key} in your .tex file
+
+### Markdown Workflow
+1. Search for papers while writing
+2. Get formatted citation (APA, MLA, etc.)
+3. Insert inline: (Author, Year) or [1]
+4. Generate reference list at document end
+```
+
+## Batch Operations
+
+```python
+def build_bibliography(queries, output_file="refs.bib"):
+    """Build BibTeX file from multiple search queries."""
+    all_bibtex = []
+    seen_ids = set()
+
+    for query in queries:
+        papers = search_papers(query, limit=3)
+        for paper in papers:
+            pid = paper.get("paperId")
+            if pid and pid not in seen_ids:
+                seen_ids.add(pid)
+                bibtex = get_bibtex(pid)
+                all_bibtex.append(bibtex)
+
+    with open(output_file, "w") as f:
+        f.write("\n\n".join(all_bibtex))
+    print(f"Wrote {len(all_bibtex)} entries to {output_file}")
+
+build_bibliography([
+    "attention mechanism",
+    "transformer architecture",
+    "BERT pre-training",
+])
+```
+
+## Use Cases
+
+1. **Paper writing**: Look up and format citations inline
+2. **Literature review**: Discover related papers from seed papers
+3. **Reference management**: Build BibTeX files from searches
+4. **Citation analysis**: Explore how papers cite each other
+5. **Quick lookup**: Find DOI, venue, citation count for any paper
+
+## References
+
+- [Citation Assistant GitHub](https://github.com/ZhangNy301/citation-assistant)
+- [Semantic Scholar API](https://api.semanticscholar.org/)

package/skills/writing/citation/jabref-reference-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Guide to JabRef open-source BibTeX and BibLaTeX reference manager"
 metadata:
   openclaw:
     emoji: "📖"
-    category: writing
-    subcategory: citation
+    category: "writing"
+    subcategory: "citation"
     keywords: ["jabref", "bibtex", "biblatex", "reference-manager", "latex", "bibliography"]
     source: "https://github.com/JabRef/jabref"
 ---

package/skills/writing/citation/jasminum-zotero-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Guide to Jasminum for retrieving CNKI Chinese academic metadata in
 metadata:
   openclaw:
     emoji: "🌸"
-    category: writing
-    subcategory: citation
+    category: "writing"
+    subcategory: "citation"
     keywords: ["zotero", "cnki", "chinese-academic", "jasminum", "metadata", "bibliography"]
     source: "https://github.com/l0o0/jasminum"
 ---