@wentorai/research-plugins 1.0.0 → 1.2.0

package/skills/writing/templates/scientific-article-pdf/SKILL.md

@@ -0,0 +1,261 @@
+---
+name: scientific-article-pdf
+description: "Generate publication-ready scientific article PDFs from templates"
+metadata:
+  openclaw:
+    emoji: "📑"
+    category: "writing"
+    subcategory: "templates"
+    keywords: ["PDF generation", "article template", "publication-ready", "journal format", "LaTeX template", "manuscript"]
+    source: "https://github.com/elunez/eladmin"
+---
+
+# Scientific Article PDF
+
+## Overview
+
+Producing a publication-ready PDF that meets the exact formatting requirements of a target journal or conference is one of the final and most frustrating steps of the research publication process. Each venue has its own LaTeX class file, formatting rules, margin specifications, font requirements, and reference style. Getting these details wrong can lead to desk rejection before your paper even reaches a reviewer.
+
+This skill provides a systematic approach to generating correctly formatted scientific article PDFs. It covers obtaining and using official LaTeX templates, configuring common elements (title blocks, author affiliations, abstracts, section numbering, bibliography), and troubleshooting formatting issues that arise during compilation. The goal is to produce a PDF that compiles cleanly and passes the publisher's automated format checks on the first try.
+
+The skill focuses on LaTeX-based workflows, as LaTeX remains the standard for most scientific venues, particularly in STEM fields. It includes guidance for major publishers and conference families.
+
+## Obtaining Official Templates
+
+### Major Publisher Templates
+
+Always start from the official template provided by your target venue. Using a custom or outdated template is a common cause of formatting problems.
+
+**IEEE:**
+```bash
+# IEEE conference and journal templates
+# Download from: https://www.ieee.org/conferences/publishing/templates.html
+# Key files: IEEEtran.cls, IEEEtran.bst
+wget https://www.ieee.org/content/dam/ieee-org/ieee/web/org/pubs/conference-latex-template_10-17-19.zip
+```
+
+**ACM (Association for Computing Machinery):**
+```bash
+# ACM Primary Article Template
+# Download from: https://www.acm.org/publications/proceedings-template
+# Key file: acmart.cls (supports all ACM formats)
+# Use: \documentclass[sigconf]{acmart}  % for conference
+#      \documentclass[acmlarge]{acmart}  % for journal
+```
+
+**Springer (LNCS - Lecture Notes in Computer Science):**
+```bash
+# Download from: https://www.springer.com/gp/computer-science/lncs/conference-proceedings-guidelines
+# Key file: llncs.cls
+# Typical usage: \documentclass[runningheads]{llncs}
+```
+
+**Elsevier:**
+```bash
+# Elsevier article template
+# Download from: https://www.elsevier.com/authors/policies-and-guidelines/latex-instructions
+# Key file: elsarticle.cls
+# Usage: \documentclass[preprint,12pt]{elsarticle}  % for submission
+#        \documentclass[final,3p,times]{elsarticle}  % for camera-ready
+```
+
+**NeurIPS / ICML / ICLR:**
+```bash
+# NeurIPS: https://neurips.cc/Conferences/2026/PaperInformation/StyleFiles
+# ICML: https://icml.cc/Conferences/2026/StyleAuthorInstructions
+# ICLR: Uses OpenReview; template available from submission portal
+```
+
+### Template Verification
+
+After downloading a template, verify it compiles correctly before writing:
+
+```bash
+# Compile the sample document
+pdflatex sample.tex
+bibtex sample       # or biber sample
+pdflatex sample.tex
+pdflatex sample.tex  # Two passes to resolve references
+
+# Check for warnings
+grep -i "warning" sample.log | head -20
+```
+
+## Document Structure Template
+
+Here is a general-purpose structure that works across most scientific article templates:
+
+```latex
+\documentclass[options]{template-class}
+
+% ========== Packages ==========
+\usepackage[utf8]{inputenc}     % UTF-8 encoding
+\usepackage{amsmath,amssymb}    % Math symbols
+\usepackage{graphicx}           % Figures
+\usepackage{booktabs}           % Professional tables
+\usepackage{hyperref}           % Clickable links
+\usepackage{algorithm2e}        % Algorithm pseudocode
+\usepackage{microtype}          % Typographic refinement
+
+% ========== Metadata ==========
+\title{Your Paper Title}
+\author{%
+  Author One\thanks{Corresponding author: author@example.edu} \\
+  University of Example \\
+  \and
+  Author Two \\
+  Institute of Research
+}
+\date{}
+
+\begin{document}
+\maketitle
+
+\begin{abstract}
+Your abstract text here (typically 150-300 words).
+\end{abstract}
+
+\section{Introduction}
+\label{sec:intro}
+
+\section{Related Work}
+\label{sec:related}
+
+\section{Method}
+\label{sec:method}
+
+\section{Experiments}
+\label{sec:experiments}
+
+\section{Conclusion}
+\label{sec:conclusion}
+
+\section*{Acknowledgments}
+This work was supported by...
+
+\bibliographystyle{template-bst}
+\bibliography{references}
+
+\appendix
+\section{Additional Results}
+\label{app:results}
+
+\end{document}
+```
+
+## Common Formatting Tasks
+
+### Professional Tables with booktabs
+
+```latex
+\begin{table}[t]
+\centering
+\caption{Comparison of methods on the benchmark dataset.}
+\label{tab:results}
+\begin{tabular}{lccc}
+\toprule
+Method & Accuracy & F1 Score & Params (M) \\
+\midrule
+Baseline A & 82.3 & 79.1 & 110 \\
+Baseline B & 84.7 & 81.4 & 145 \\
+\textbf{Ours} & \textbf{87.6} & \textbf{84.9} & 95 \\
+\bottomrule
+\end{tabular}
+\end{table}
+```
+
+### Figure Placement
+
+```latex
+\begin{figure}[t]  % [t]=top, [b]=bottom, [h]=here, [p]=page of floats
+\centering
+\includegraphics[width=0.9\columnwidth]{figures/architecture.pdf}
+\caption{Overview of the proposed architecture. The encoder (left)
+processes input features while the decoder (right) generates
+predictions autoregressively.}
+\label{fig:architecture}
+\end{figure}
+```
+
+### Algorithm Pseudocode
+
+```latex
+\begin{algorithm}[t]
+\caption{Training Procedure}
+\label{alg:training}
+\KwIn{Dataset $\mathcal{D}$, learning rate $\eta$, epochs $T$}
+\KwOut{Trained model parameters $\theta^*$}
+Initialize $\theta$ randomly\;
+\For{$t = 1$ \KwTo $T$}{
+    \ForEach{batch $(x, y) \in \mathcal{D}$}{
+        $\hat{y} \gets f_\theta(x)$\;
+        $\mathcal{L} \gets \text{Loss}(\hat{y}, y)$\;
+        $\theta \gets \theta - \eta \nabla_\theta \mathcal{L}$\;
+    }
+}
+\Return $\theta$\;
+\end{algorithm}
+```
+
+## Build Pipeline and Automation
+
+### Makefile for Clean Builds
+
+```makefile
+MAIN = paper
+LATEX = pdflatex
+BIB = bibtex
+
+all: $(MAIN).pdf
+
+$(MAIN).pdf: $(MAIN).tex references.bib
+	$(LATEX) $(MAIN)
+	$(BIB) $(MAIN)
+	$(LATEX) $(MAIN)
+	$(LATEX) $(MAIN)
+
+clean:
+	rm -f *.aux *.bbl *.blg *.log *.out *.toc *.fls *.fdb_latexmk
+
+check:
+	@echo "=== Overfull boxes ==="
+	@grep -c "Overfull" $(MAIN).log || echo "None"
+	@echo "=== Undefined references ==="
+	@grep -c "undefined" $(MAIN).log || echo "None"
+	@echo "=== Missing citations ==="
+	@grep -c "Citation.*undefined" $(MAIN).log || echo "None"
+
+.PHONY: all clean check
+```
+
+### Using latexmk for Automatic Rebuilds
+
+```bash
+# latexmk automatically determines how many passes are needed
+latexmk -pdf paper.tex
+
+# Continuous mode: recompiles on file changes
+latexmk -pdf -pvc paper.tex
+
+# Clean up auxiliary files
+latexmk -c paper.tex
+```
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| "Overfull hbox" warnings | Rephrase text, use `\sloppy` locally, or adjust figure widths |
+| Missing references | Run BibTeX/Biber and re-run LaTeX twice |
+| Figures not found | Use paths relative to the main .tex file; check file extensions |
+| Font not found | Install the required font package: `tlmgr install <font>` |
+| Page limit exceeded | Move content to appendix; tighten prose; reduce figure sizes |
+| "Too many unprocessed floats" | Add `\clearpage` or use the `placeins` package with `\FloatBarrier` |
+
+## References
+
+- IEEE LaTeX templates: https://www.ieee.org/conferences/publishing/templates.html
+- ACM acmart class: https://www.acm.org/publications/proceedings-template
+- Springer LNCS: https://www.springer.com/gp/computer-science/lncs
+- Elsevier elsarticle: https://www.elsevier.com/authors/policies-and-guidelines/latex-instructions
+- LaTeX Wikibook: https://en.wikibooks.org/wiki/LaTeX

package/skills/writing/templates/sjtuthesis-guide/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: sjtuthesis-guide
+description: "Write SJTU theses using the SJTUThesis LaTeX template with full compliance"
+metadata:
+  openclaw:
+    emoji: "🎓"
+    category: "writing"
+    subcategory: "templates"
+    keywords: ["latex", "thesis", "sjtu", "template", "academic-writing", "shanghai-jiaotong"]
+    source: "https://github.com/sjtug/SJTUThesis"
+---
+
+# SJTUThesis Guide
+
+## Overview
+
+SJTUThesis is the community-maintained LaTeX thesis template for Shanghai Jiao Tong University (SJTU), one of China's top research universities. Developed and maintained by SJTUG (SJTU Linux User Group), the template encodes all formatting requirements specified by SJTU's graduate school, enabling students to produce professionally typeset theses without manually adjusting margins, fonts, heading styles, or citation formats.
+
+The template has evolved over many years through contributions from hundreds of SJTU students and alumni, resulting in a mature and battle-tested codebase that handles the many edge cases in Chinese academic typesetting. It supports bachelor's, master's, and doctoral degrees, accommodating differences in title page layout, committee requirements, and structural organization between degree levels.
+
+With approximately 4,000 GitHub stars, SJTUThesis represents one of the most widely used university-specific LaTeX templates in the Chinese academic ecosystem. Its design principles and code patterns have influenced thesis templates at many other Chinese universities.
+
+## Installation and Setup
+
+**Prerequisites**: Install a full TeX distribution with XeLaTeX support:
+
+```bash
+# macOS
+brew install --cask mactex
+
+# Ubuntu/Debian
+sudo apt-get install texlive-full
+
+# Windows: install TeX Live or MiKTeX from official sites
+```
+
+**Download and Initialize**:
+
+```bash
+git clone https://github.com/sjtug/SJTUThesis.git
+cd SJTUThesis
+```
+
+Or download the latest release archive from the GitHub releases page.
+
+**First Compilation**:
+
+```bash
+# Recommended: use latexmk
+latexmk -xelatex main.tex
+
+# Alternative: manual compilation
+xelatex main.tex
+biber main
+xelatex main.tex
+xelatex main.tex
+```
+
+The template requires XeLaTeX for proper Chinese font handling. Ensure the required CJK fonts are available on your system. On Windows, the standard SimSun, SimHei, and KaiTi fonts are used by default. On macOS and Linux, the template can be configured to use alternative fonts.
+
+**Font Configuration**: If system fonts differ from the defaults, modify the font setup:
+
+```latex
+% In the preamble or configuration file
+\documentclass[
+  type=master,
+  fontset=mac   % Options: windows, mac, ubuntu, fandol
+]{sjtuthesis}
+```
+
+## Core Features
+
+**Degree Type Selection**: Configure the thesis type through document class options:
+
+```latex
+\documentclass[
+  type=doctor,      % bachelor, master, doctor
+  language=chinese, % chinese or english
+  review=false      % Set true for blind review version
+]{sjtuthesis}
+```
+
+The `review=true` option automatically strips author names, advisor information, and acknowledgements to produce an anonymous version for external review.
+
+**Thesis Information Setup**: Define all metadata in a structured configuration block:
+
+```latex
+\sjtusetup{
+  info = {
+    title = {Research on Graph Neural Networks for Molecular Property Prediction},
+    title* = {Chinese title here},
+    author = {Wang Wu},
+    supervisor = {Prof. Zhao Liu},
+    department = {School of Chemistry and Chemical Engineering},
+    major = {Chemical Engineering},
+    date = {2026-06-15},
+    keywords = {graph neural networks, molecular properties, deep learning},
+    keywords* = {Chinese keywords here},
+  },
+}
+```
+
+**Bibliography with GB/T 7714**: The template integrates the Chinese national bibliography standard:
+
+```latex
+% Bibliography is configured automatically
+% Simply maintain your refs.bib file and cite normally
+\cite{wang2024molecular}
+\parencite{zhang2023graphnn}
+```
+
+BibLaTeX with Biber backend is used by default, supporting the full range of entry types and fields required for Chinese academic citations including patent numbers, technical standards, and government documents.
+
+**Mathematical Environments**: Theorem-like environments are pre-configured with Chinese labels:
+
+```latex
+\begin{theorem}[Convergence Guarantee]\label{thm:main}
+  Let $f: \mathbb{R}^d \to \mathbb{R}$ be $L$-smooth and $\mu$-strongly convex.
+  Then the proposed algorithm converges at rate $O(1/k^2)$.
+\end{theorem}
+
+\begin{proof}
+  We proceed by establishing a Lyapunov function...
+\end{proof}
+
+\begin{definition}\label{def:stability}
+  A solution $x^*$ is said to be locally stable if...
+\end{definition}
+```
+
+## Project Structure
+
+The template organizes thesis components into a clean directory hierarchy:
+
+```
+SJTUThesis/
+  main.tex                  # Master document
+  sjtuthesis.cls            # Class file
+  contents/
+    abstract.tex            # Chinese and English abstracts
+    intro.tex               # Introduction chapter
+    literature.tex          # Literature review
+    methodology.tex         # Methods
+    results.tex             # Results and discussion
+    conclusion.tex          # Conclusions
+    acknowledgements.tex    # Acknowledgements
+    appendix.tex            # Appendices
+    publications.tex        # Author publications list
+  figures/                  # All figures
+  bibliography/
+    refs.bib                # BibTeX database
+```
+
+Each chapter is maintained as a separate file and included via the master document. This modular structure supports independent compilation of chapters during drafting and simplifies version control.
+
+## Research Workflow Integration
+
+**Git-Based Collaboration**: Track thesis progress with version control, create branches for experimental sections, and use meaningful commit messages to document your writing journey:
+
+```bash
+git init
+git add main.tex contents/ figures/ bibliography/
+git commit -m "Chapter 3: complete methodology section"
+```
+
+**Continuous Preview**: Use latexmk watch mode for real-time PDF updates during writing sessions:
+
+```bash
+latexmk -xelatex -pvc main.tex
+```
+
+**Integration with Reference Managers**: Export BibTeX entries from Zotero, Mendeley, or other managers directly into the `refs.bib` file. Use Better BibTeX for Zotero for automatic citation key generation and export synchronization.
+
+**Overleaf Deployment**: Upload the complete template to Overleaf for browser-based editing. Set compiler to XeLaTeX. For Overleaf, use `fontset=fandol` since Fandol fonts are available on the Overleaf platform.
+
+**Blind Review Preparation**: When submitting your thesis for external review, simply toggle the review flag and recompile:
+
+```bash
+# Edit main.tex: set review=true
+latexmk -xelatex main.tex
+# Output PDF has all identifying information removed
+```
+
+## Common Issues and Solutions
+
+**Missing fonts**: Use the `fandol` fontset option if system CJK fonts are unavailable. Fandol provides open-source Chinese fonts included with TeX Live.
+
+**Bibliography errors**: Ensure you run Biber (not BibTeX) as the bibliography processor. Check that all cited keys exist in your `.bib` file.
+
+**Long table formatting**: For tables spanning multiple pages, use the `longtable` environment which is pre-configured in the template to match SJTU formatting requirements.
+
+## References
+
+- SJTUThesis repository: https://github.com/sjtug/SJTUThesis
+- SJTU graduate school formatting guidelines
+- SJTUG user group: https://sjtug.org/
+- LaTeX workshop materials from SJTUG

package/skills/writing/templates/thuthesis-guide/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: thuthesis-guide
+description: "Write Tsinghua University theses using the ThuThesis LaTeX template"
+metadata:
+  openclaw:
+    emoji: "🎓"
+    category: "writing"
+    subcategory: "templates"
+    keywords: ["latex", "thesis", "tsinghua", "template", "academic-writing", "typesetting"]
+    source: "https://github.com/tuna/thuthesis"
+---
+
+# ThuThesis Guide
+
+## Overview
+
+ThuThesis is the official LaTeX thesis template for Tsinghua University, one of China's most prestigious research institutions. Maintained by TUNA (Tsinghua University Network Administrators), the template provides comprehensive formatting for bachelor's, master's, and doctoral theses, as well as postdoctoral reports, ensuring full compliance with Tsinghua University's stringent formatting requirements.
+
+Writing a thesis involves balancing content creation with precise typographic standards. ThuThesis eliminates the formatting burden by encoding all institutional requirements into LaTeX class files: page margins, font selections, heading hierarchy, bibliography formatting, front matter structure, and appendix layout are all handled automatically. Researchers can focus entirely on writing while the template ensures every page, caption, and citation meets the graduation office requirements.
+
+With over 5,000 GitHub stars, ThuThesis has become the de facto standard for thesis typesetting at Tsinghua. Its codebase also serves as a reference implementation for other university thesis templates in China, influencing templates at dozens of institutions.
+
+## Installation and Setup
+
+**TeX Live Installation** (recommended):
+
+ThuThesis requires a complete TeX distribution. Install TeX Live (full scheme recommended to avoid missing packages):
+
+```bash
+# On macOS via Homebrew
+brew install --cask mactex
+
+# On Ubuntu/Debian
+sudo apt-get install texlive-full
+
+# On Windows, download TeX Live from tug.org/texlive
+```
+
+**Download ThuThesis**:
+
+```bash
+git clone https://github.com/tuna/thuthesis.git
+cd thuthesis
+```
+
+Alternatively, download the latest release from the GitHub releases page or install via CTAN:
+
+```bash
+tlmgr install thuthesis
+```
+
+**Compile the template**:
+
+```bash
+# Using latexmk (recommended)
+latexmk -xelatex main.tex
+
+# Or manually
+xelatex main.tex
+bibtex main
+xelatex main.tex
+xelatex main.tex
+```
+
+XeLaTeX is required rather than pdfLaTeX because the template uses system fonts for Chinese typesetting. Ensure you have the required fonts installed (SimSun, SimHei, KaiTi, FangSong for Windows; or their equivalents on macOS and Linux).
+
+## Core Features
+
+**Degree Type Configuration**: A single configuration option switches between thesis formats:
+
+```latex
+\documentclass[
+  degree=doctor,       % bachelor, master, doctor, or postdoc
+  degree-type=academic % academic or professional
+]{thuthesis}
+```
+
+Each degree type automatically adjusts title page layout, committee signature pages, abstract formatting, and chapter numbering conventions.
+
+**Bilingual Support**: Tsinghua requires both Chinese and English abstracts, title pages, and keywords. ThuThesis provides dedicated environments for each:
+
+```latex
+\begin{abstract}
+  This thesis investigates the application of deep learning methods
+  to protein structure prediction, focusing on attention mechanisms
+  that capture long-range amino acid interactions.
+\end{abstract}
+
+\begin{abstract*}
+  % Chinese abstract here
+\end{abstract*}
+```
+
+**Bibliography Management**: The template integrates with BibTeX and supports the GB/T 7714 citation standard required by Chinese academic institutions:
+
+```latex
+\usepackage[backend=bibtex, style=gb7714-2015]{biblatex}
+\addbibresource{references.bib}
+
+% In text
+\cite{einstein1905}
+\parencite{dirac1928}
+```
+
+**Mathematical Typesetting**: Full support for equations, theorems, and proofs with consistent numbering tied to chapter structure:
+
+```latex
+\begin{theorem}\label{thm:convergence}
+  Under assumptions A1--A3, the proposed estimator converges
+  at rate $O(n^{-1/2})$ uniformly over the parameter space.
+\end{theorem}
+
+\begin{proof}
+  By the triangle inequality and Lemma~\ref{lem:concentration}...
+\end{proof}
+```
+
+**Figure and Table Formatting**: Captions, numbering, and cross-referencing follow institutional standards automatically. The template supports subfigures and multi-page tables.
+
+## Thesis Structure and Organization
+
+ThuThesis provides a standard project structure:
+
+```
+thuthesis/
+  main.tex              # Master document
+  thuthesis.cls         # Class file (do not modify)
+  thuthesis-setup.tex   # Personal info and thesis metadata
+  data/
+    abstract.tex        # Abstracts (CN + EN)
+    chap01.tex          # Chapter 1
+    chap02.tex          # Chapter 2
+    ...
+    appendix01.tex      # Appendices
+    acknowledgements.tex
+    resume.tex          # Publication list
+  figures/              # All figures
+  ref/
+    refs.bib            # Bibliography database
+```
+
+Edit `thuthesis-setup.tex` to fill in your personal information:
+
+```latex
+\thusetup{
+  title  = {Deep Learning for Protein Structure Prediction},
+  title* = {Your Chinese title here},
+  author = {Zhang San},
+  supervisor = {Prof. Li Si},
+  degree-name = {Doctor of Engineering},
+  department = {Department of Computer Science},
+  date = {2026-06-01},
+}
+```
+
+## Research Workflow Integration
+
+**Version Control**: The plain-text LaTeX source works seamlessly with Git. Track changes across drafts, collaborate with advisors via pull requests, and maintain a complete revision history:
+
+```bash
+git init
+git add main.tex data/ figures/ ref/
+git commit -m "Initial thesis structure"
+```
+
+**Continuous Compilation**: Use latexmk in watch mode during writing for immediate feedback:
+
+```bash
+latexmk -xelatex -pvc main.tex
+```
+
+**Overleaf Compatibility**: Upload the ThuThesis files to Overleaf for cloud-based editing. Set the compiler to XeLaTeX in project settings. Note that some system fonts may not be available on Overleaf; the template includes fallback font configurations.
+
+**Advisor Collaboration**: Generate PDF versions for advisor review while maintaining the LaTeX source as the canonical version. Use PDF annotation tools for feedback and incorporate changes back into the source files.
+
+## References
+
+- ThuThesis repository: https://github.com/tuna/thuthesis
+- CTAN package page: https://ctan.org/pkg/thuthesis
+- Tsinghua University thesis formatting guidelines (available through the graduate school)
+- TUNA association: https://tuna.moe/