@wentorai/research-plugins 1.2.2 → 1.3.0

package/skills/tools/knowledge-graph/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: knowledge-graph-skills
+description: "10 knowledge graphs skills (citation-network-builder, concept-map-generator, graphiti, knowledge-graph-construction...). Trigger: building knowledge graphs, connecting concepts, ontology design. Design: graph construction, traversal, and visualization for research knowledge."
+---
+
+# Knowledge Graphs — 10 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [citation-network-builder](./citation-network-builder/SKILL.md) | Build and analyze citation networks from academic reference data |
+| [concept-map-generator](./concept-map-generator/SKILL.md) | Generate structured concept maps from academic texts automatically |
+| [graphiti-guide](./graphiti-guide/SKILL.md) | Build real-time knowledge graphs for AI agents using Graphiti by Zep |
+| [knowledge-graph-construction](./knowledge-graph-construction/SKILL.md) | Build research knowledge graphs for literature synthesis and RAG systems |
+| [notero-zotero-notion-guide](./notero-zotero-notion-guide/SKILL.md) | Sync Zotero references and annotations to Notion databases |
+| [ontology-design-guide](./ontology-design-guide/SKILL.md) | Design ontologies and knowledge graphs for research data modeling |
+| [openspg-guide](./openspg-guide/SKILL.md) | Ant Group knowledge graph engine with SPG and KAG framework |
+| [paperpile-notion-guide](./paperpile-notion-guide/SKILL.md) | Sync Paperpile references and annotations to Notion |
+| [rag-methodology-guide](./rag-methodology-guide/SKILL.md) | RAG architecture for academic knowledge retrieval and synthesis |
+| [zotero-markdb-connect-guide](./zotero-markdb-connect-guide/SKILL.md) | Sync Zotero references to Obsidian and Logseq markdown |

package/skills/tools/ocr-translate/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ocr-translate-skills
+description: "7 ocr & translation skills (handwriting-recognition, latex-ocr, latex-translation, multilingual-research...). Trigger: scanning documents, recognizing formulas, translating academic papers. Design: specialized OCR (LaTeX, handwriting) and translation for scholarly content."
+---
+
+# OCR & Translation — 7 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [handwriting-recognition-guide](./handwriting-recognition-guide/SKILL.md) | Apply handwriting OCR to digitize historical and archival documents |
+| [latex-ocr-guide](./latex-ocr-guide/SKILL.md) | Extract and convert mathematical formulas from images and PDFs to LaTeX code |
+| [latex-translation-guide](./latex-translation-guide/SKILL.md) | Translate LaTeX documents preserving math formulas and structure |
+| [multilingual-research-guide](./multilingual-research-guide/SKILL.md) | Strategies for translating academic papers while preserving technical accuracy |
+| [pdf-math-translate-guide](./pdf-math-translate-guide/SKILL.md) | Translate scientific PDFs with preserved math formatting via PDFMathTranslate |
+| [zotero-pdf-translate-guide](./zotero-pdf-translate-guide/SKILL.md) | Guide to Zotero PDF Translate for multilingual PDF and annotation translation |
+| [zotero-pdf2zh-guide](./zotero-pdf2zh-guide/SKILL.md) | PDF Chinese translation plugin for Zotero reference manager |

package/skills/tools/ocr-translate/handwriting-recognition-guide/SKILL.md

@@ -42,6 +42,8 @@ Challenges specific to historical documents:
 
 ### Transkribus (State of the Art for Historical Documents)
 
+**Pricing note:** Transkribus uses a credit-based pricing model. A limited free tier is available, but processing large volumes of pages requires purchasing credits.
+
 ```
 Transkribus is the leading platform for historical HTR.
 

package/skills/tools/ocr-translate/latex-ocr-guide/SKILL.md

@@ -154,6 +154,8 @@ def preprocess_handwritten(image_path: str) -> Image.Image:
 
 ## Using Mathpix API
 
+**Pricing note:** Mathpix is a paid service (starting at $5/month). For free open-source alternatives, use pix2tex/LaTeX-OCR or Nougat (Meta), both MIT-licensed and capable of running locally.
+
 For production-quality results, the Mathpix API provides the highest accuracy:
 
 ```python

package/skills/tools/scraping/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: scraping-skills
+description: "6 web scraping & data collection skills (academic-web-scraping, dataset-finder, easy-spider, google-scholar-scraper...). Trigger: collecting web data, finding datasets, API access for research. Design: ethical scraping methods with rate limiting and data quality checks."
+---
+
+# Web Scraping & Data Collection — 6 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [academic-web-scraping](./academic-web-scraping/SKILL.md) | Ethical web scraping and API-based data collection for research |
+| [dataset-finder-guide](./dataset-finder-guide/SKILL.md) | Search and download research datasets from Kaggle, HuggingFace, and repos |
+| [easy-spider-guide](./easy-spider-guide/SKILL.md) | Guide to EasySpider for visual no-code web data collection |
+| [google-scholar-scraper](./google-scholar-scraper/SKILL.md) | Ethical Google Scholar data collection techniques and best practices |
+| [repository-harvesting-guide](./repository-harvesting-guide/SKILL.md) | Harvest metadata from open repositories using OAI-PMH protocol |
+| [web-scraping-ethics-guide](./web-scraping-ethics-guide/SKILL.md) | Scrape web data ethically and legally for research purposes |

package/skills/writing/citation/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: citation-skills
+description: "22 citation management skills (academic-citation-manager, bibtex-management, citation-assistant-skill, citation-style...). Trigger: managing references, formatting citations, BibTeX, bibliographies. Design: reference manager integrations and citation style guides (APA, IEEE, etc.)."
+---
+
+# Citation Management — 22 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [academic-citation-manager](./academic-citation-manager/SKILL.md) | Manage academic citations across BibTeX, APA, MLA, and Chicago formats |
+| [bibtex-management-guide](./bibtex-management-guide/SKILL.md) | Clean, format, deduplicate, and manage BibTeX bibliography files for LaTeX |
+| [citation-assistant-skill](./citation-assistant-skill/SKILL.md) | Claude Code skill for citation workflow via Semantic Scholar |
+| [citation-style-guide](./citation-style-guide/SKILL.md) | APA, MLA, Chicago citation format guide with CSL configuration |
+| [jabref-reference-guide](./jabref-reference-guide/SKILL.md) | Guide to JabRef open-source BibTeX and BibLaTeX reference manager |
+| [jasminum-zotero-guide](./jasminum-zotero-guide/SKILL.md) | Guide to Jasminum for retrieving CNKI Chinese academic metadata in Zotero |
+| [mendeley-api](./mendeley-api/SKILL.md) | Manage references and search Mendeley's catalog via REST API |
+| [obsidian-citation-guide](./obsidian-citation-guide/SKILL.md) | Citation plugin for Obsidian note-taking with BibTeX support |
+| [obsidian-zotero-guide](./obsidian-zotero-guide/SKILL.md) | Insert citations and notes from Zotero into Obsidian knowledge bases |
+| [onecite-reference-guide](./onecite-reference-guide/SKILL.md) | AI toolkit to parse, complete, and format academic references |
+| [papersgpt-zotero-guide](./papersgpt-zotero-guide/SKILL.md) | AI plugin for Zotero with ChatGPT, Claude, and DeepSeek support |
+| [papis-cli-guide](./papis-cli-guide/SKILL.md) | Guide to Papis command-line document and bibliography manager for researchers |
+| [reference-manager-comparison](./reference-manager-comparison/SKILL.md) | Compare Zotero, Mendeley, EndNote, and Paperpile for research use |
+| [zotero-api](./zotero-api/SKILL.md) | Reference management library and collections API |
+| [zotero-better-bibtex-guide](./zotero-better-bibtex-guide/SKILL.md) | Guide to Better BibTeX for Zotero for LaTeX and BibTeX workflows |
+| [zotero-better-notes-guide](./zotero-better-notes-guide/SKILL.md) | Guide to Zotero Better Notes for comprehensive note-taking in research |
+| [zotero-gpt-guide](./zotero-gpt-guide/SKILL.md) | Guide to Zotero GPT for AI-powered research assistance within Zotero |
+| [zotero-mcp-guide](./zotero-mcp-guide/SKILL.md) | Guide to Zotero MCP for connecting Zotero library with AI assistants |
+| [zotero-mdnotes-guide](./zotero-mdnotes-guide/SKILL.md) | Export Zotero items and annotations to Markdown note files |
+| [zotero-reference-guide](./zotero-reference-guide/SKILL.md) | PDF references add-on for enriching Zotero library metadata |
+| [zotero-scholar-guide](./zotero-scholar-guide/SKILL.md) | Save papers with metadata to Zotero via its API programmatically |
+| [zotfile-attachment-guide](./zotfile-attachment-guide/SKILL.md) | Guide to ZotFile for Zotero attachment management, renaming, and syncing |

package/skills/writing/citation/zotfile-attachment-guide/SKILL.md

@@ -12,6 +12,8 @@ metadata:
 
 # ZotFile Attachment Management Guide
 
+**WARNING: ZotFile is NOT compatible with Zotero 7.** For Zotero 7, use the built-in attachment management or the [Attanger](https://github.com/MuiseDestiny/zotero-attanger) plugin as a replacement.
+
 ## Overview
 
 ZotFile is one of the most established Zotero plugins with over 4,000 GitHub stars, providing advanced file management capabilities for PDF attachments and other documents linked to your Zotero library. It handles the critical but often neglected task of organizing, renaming, and synchronizing the actual files that make up a research library.

package/skills/writing/composition/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: composition-skills
+description: "11 academic writing skills (abstract-writing, discussion-writing, introduction-writing, literature-review-writing...). Trigger: writing paper sections, structuring arguments, academic prose. Design: section-by-section guides (abstract, intro, methods, discussion) with templates."
+---
+
+# Academic Writing — 11 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [abstract-writing-guide](./abstract-writing-guide/SKILL.md) | Craft structured research abstracts that maximize clarity and journal acceptance |
+| [discussion-writing-guide](./discussion-writing-guide/SKILL.md) | Write effective discussion sections that interpret results and impact |
+| [introduction-writing-guide](./introduction-writing-guide/SKILL.md) | Guide to writing effective research paper introductions |
+| [literature-review-writing](./literature-review-writing/SKILL.md) | Structure and write comprehensive literature reviews for any field |
+| [methods-section-guide](./methods-section-guide/SKILL.md) | Guide to writing clear and reproducible methodology sections |
+| [ml-paper-writing](./ml-paper-writing/SKILL.md) | Write ML/AI research papers targeting NeurIPS, ICML, and ICLR venues |
+| [research-paper-writer](./research-paper-writer/SKILL.md) | Guide for writing formal academic papers following IEEE and ACM standards |
+| [response-to-reviewers](./response-to-reviewers/SKILL.md) | Write effective point-by-point responses to peer reviewer comments for revisions |
+| [scientific-writing-guide](./scientific-writing-guide/SKILL.md) | Curated tools and techniques for scientific writing beyond LaTeX |
+| [scientific-writing-resources](./scientific-writing-resources/SKILL.md) | Curated tools and resources for effective scientific writing |
+| [scientific-writing-wrapper](./scientific-writing-wrapper/SKILL.md) | AI-powered scientific writing workflow from outline to polished draft |

package/skills/writing/composition/research-paper-writer/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "composition"
     keywords: ["academic writing", "IEEE format", "ACM format", "paper structure", "manuscript preparation", "citation formatting"]
-    source: "https://clawhub.ai/Veeramanikandanr48/research-paper-writer"
+    source: "wentor-research-plugins"
 ---
 
 # Research Paper Writer — IEEE/ACM Standards Guide

package/skills/writing/composition/scientific-writing-wrapper/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "composition"
     keywords: ["scientific writing", "AI writing", "draft generation", "writing workflow", "paper composition", "manuscript"]
-    source: "https://github.com/papercopilot/papercopilot"
+    source: "wentor-research-plugins"
 ---
 
 # Scientific Writing Wrapper

package/skills/writing/latex/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: latex-skills
+description: "11 latex skills (academic-writing-latex, bibliography-management, latex-drawing-collection, latex-drawing...). Trigger: LaTeX typesetting, formatting papers, mathematical notation, Beamer. Design: template-based guides with package recommendations and compilation tips."
+---
+
+# LaTeX — 11 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [academic-writing-latex](./academic-writing-latex/SKILL.md) | LaTeX-based academic writing assistant for thesis and paper templates |
+| [bibliography-management-guide](./bibliography-management-guide/SKILL.md) | Manage references with BibLaTeX, natbib, and LaTeX bibliography styles |
+| [latex-drawing-collection](./latex-drawing-collection/SKILL.md) | LaTeX drawing examples for Bayesian networks, tensors, and diagrams |
+| [latex-drawing-guide](./latex-drawing-guide/SKILL.md) | TikZ and PGFPlots techniques for publication-quality scientific figures |
+| [latex-ecosystem-guide](./latex-ecosystem-guide/SKILL.md) | Comprehensive guide to LaTeX editors, packages, and typesetting workflows |
+| [latex-templates-collection](./latex-templates-collection/SKILL.md) | Collection of LaTeX templates for papers, presentations, and CVs |
+| [math-typesetting-guide](./math-typesetting-guide/SKILL.md) | LaTeX math typesetting, equation formatting, and cross-referencing |
+| [md-to-pdf-academic](./md-to-pdf-academic/SKILL.md) | Convert Markdown to publication-quality PDF with LaTeX math rendering |
+| [overleaf-collaboration-guide](./overleaf-collaboration-guide/SKILL.md) | Guide to collaborative LaTeX editing with Overleaf |
+| [tex-render-guide](./tex-render-guide/SKILL.md) | Render LaTeX math expressions to images in PNG, JPEG, and SVG |
+| [tikz-diagrams-guide](./tikz-diagrams-guide/SKILL.md) | Create publication-quality scientific diagrams with TikZ in LaTeX |

package/skills/writing/latex/academic-writing-latex/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "latex"
     keywords: ["latex", "thesis writing", "paper template", "academic writing", "document structure", "overleaf"]
-    source: "https://clawhub.ai/dayunyan/academic-writer"
+    source: "wentor-research-plugins"
 ---
 
 # Academic Writing with LaTeX Templates

package/skills/writing/latex/latex-drawing-guide/SKILL.md

@@ -67,7 +67,7 @@ Nodes are the building blocks of most scientific diagrams:
 
   \draw[arrow] (input) -- (process);
   \draw[arrow] (process) -- (output);
-\end{tikzpicture>
+\end{tikzpicture}
 ```
 
 ## Neural Network Diagrams

package/skills/writing/polish/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: polish-skills
+description: "9 editing & proofreading skills (academic-tone, academic-translation, academic-writing-refiner, ai-writing-humanizer...). Trigger: polishing drafts, academic tone, proofreading, translation. Design: style checkers and editing workflows for clear, concise academic English."
+---
+
+# Editing & Proofreading — 9 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [academic-tone-guide](./academic-tone-guide/SKILL.md) | Adjust writing tone and register for academic audiences and venues |
+| [academic-translation-guide](./academic-translation-guide/SKILL.md) | Academic translation, post-editing, and Chinglish correction guide |
+| [academic-writing-refiner](./academic-writing-refiner/SKILL.md) | Checklist-driven academic English polishing and Chinglish correction |
+| [ai-writing-humanizer](./ai-writing-humanizer/SKILL.md) | Remove AI-generated patterns to produce natural, authentic academic writing |
+| [chinese-text-humanizer](./chinese-text-humanizer/SKILL.md) | Transform AI-generated Chinese text into natural academic writing style |
+| [conciseness-editing-guide](./conciseness-editing-guide/SKILL.md) | Eliminate wordiness and redundancy in academic prose for clarity |
+| [grammar-checker-guide](./grammar-checker-guide/SKILL.md) | Use grammar and style checking tools to polish academic manuscripts |
+| [paper-polish-guide](./paper-polish-guide/SKILL.md) | Review and polish LaTeX research papers for clarity and style |
+| [plagiarism-detection-guide](./plagiarism-detection-guide/SKILL.md) | Use plagiarism detection tools and ensure manuscript originality |

package/skills/writing/polish/chinese-text-humanizer/SKILL.md

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "polish"
     keywords: ["chinese writing", "AI detection", "text humanization", "academic style", "natural language", "chinese academic"]
-    source: "https://clawhub.ai/anisafifi/chinese-humanizer"
+    source: "wentor-research-plugins"
 ---
 
 # Chinese Academic Text Humanizer

package/skills/writing/templates/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: templates-skills
+description: "11 paper templates skills (arxiv-preprint-template, beamer-presentation, conference-paper-template, elegant-paper-template...). Trigger: starting a new paper, formatting for submission, venue-specific layouts. Design: ready-to-use templates for arXiv preprint, conferences, thesis, and posters."
+---
+
+# Paper Templates — 11 Skills
+
+Select the skill matching the user's need, then `read` its SKILL.md.
+
+| Skill | Description |
+|-------|-------------|
+| [arxiv-preprint-template](./arxiv-preprint-template/SKILL.md) | LaTeX template for arXiv preprints in NIPS/NeurIPS style format |
+| [beamer-presentation-guide](./beamer-presentation-guide/SKILL.md) | Guide to creating academic presentations with LaTeX Beamer |
+| [conference-paper-template](./conference-paper-template/SKILL.md) | Templates and formatting guides for major academic conference submissions |
+| [elegant-paper-template](./elegant-paper-template/SKILL.md) | Beautiful LaTeX template for working papers and technical reports |
+| [graphical-abstract-guide](./graphical-abstract-guide/SKILL.md) | Create SVG graphical abstracts for journal paper submissions |
+| [novathesis-guide](./novathesis-guide/SKILL.md) | LaTeX thesis template supporting multiple universities and formats |
+| [scientific-article-pdf](./scientific-article-pdf/SKILL.md) | Generate publication-ready scientific article PDFs from templates |
+| [sjtuthesis-guide](./sjtuthesis-guide/SKILL.md) | Write SJTU theses using the SJTUThesis LaTeX template with full compliance |
+| [thesis-template-guide](./thesis-template-guide/SKILL.md) | Set up LaTeX templates for PhD and Master's thesis documents |
+| [thesis-writing-guide](./thesis-writing-guide/SKILL.md) | Templates, formatting rules, and strategies for thesis and dissertation writing |
+| [thuthesis-guide](./thuthesis-guide/SKILL.md) | Write Tsinghua University theses using the ThuThesis LaTeX template |

package/skills/writing/templates/beamer-presentation-guide/SKILL.md

@@ -143,7 +143,7 @@ Create professional academic presentations using LaTeX Beamer with themes, anima
     \includegraphics[width=0.85\textwidth]{figures/results-comparison.pdf}
     \caption{Our method (blue) outperforms baselines across all benchmarks.}
   \end{figure}
-\end{frame>
+\end{frame}
 ```
 
 ### Table Slide

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

@@ -7,7 +7,7 @@ metadata:
     category: "writing"
     subcategory: "templates"
     keywords: ["PDF generation", "article template", "publication-ready", "journal format", "LaTeX template", "manuscript"]
-    source: "https://github.com/elunez/eladmin"
+    source: "wentor-research-plugins"
 ---
 
 # Scientific Article PDF

package/skills/analysis/dataviz/citation-map-guide/SKILL.md

@@ -1,184 +0,0 @@
----
-name: citation-map-guide
-description: "Generate citation world maps from Google Scholar profiles"
-metadata:
-  openclaw:
-    emoji: "🗺️"
-    category: "analysis"
-    subcategory: "dataviz"
-    keywords: ["citation map", "Google Scholar", "geospatial", "academic impact", "visualization", "world map"]
-    source: "https://github.com/ChenLiu-1996/CitationMap"
----
-
-# Citation Map Guide
-
-## Overview
-
-CitationMap generates geographical world maps showing where your citations come from, based on Google Scholar data. It geocodes citing authors' affiliations and plots them on an interactive map, revealing the global reach and geographical distribution of your research impact. Useful for CV enhancement, grant applications, and understanding your research's international footprint.
-
-## Installation
-
-```bash
-pip install citationmap
-
-# Or from source
-git clone https://github.com/ChenLiu-1996/CitationMap.git
-cd CitationMap
-pip install -e .
-```
-
-## Usage
-
-```python
-from citationmap import CitationMap
-
-# Generate map from Google Scholar ID
-cmap = CitationMap(scholar_id="YOUR_SCHOLAR_ID")
-
-# Fetch citation data
-cmap.fetch_citations()
-
-print(f"Total citations: {cmap.total_citations}")
-print(f"Unique citing authors: {cmap.unique_authors}")
-print(f"Countries represented: {cmap.unique_countries}")
-
-# Generate interactive map
-cmap.plot_map(
-    output="citation_map.html",
-    style="heatmap",       # heatmap, markers, clusters
-    color_by="count",      # count, year, paper
-)
-```
-
-## Map Styles
-
-```python
-# Marker map — individual pins per institution
-cmap.plot_map(
-    output="markers.html",
-    style="markers",
-    show_labels=True,
-    popup_info=["author", "paper", "year"],
-)
-
-# Heatmap — density visualization
-cmap.plot_map(
-    output="heatmap.html",
-    style="heatmap",
-    radius=30,
-    blur=20,
-)
-
-# Cluster map — grouped by proximity
-cmap.plot_map(
-    output="clusters.html",
-    style="clusters",
-    max_cluster_radius=50,
-)
-
-# Static image (for publications/CVs)
-cmap.plot_static(
-    output="citation_map.png",
-    dpi=300,
-    projection="robinson",
-    figsize=(14, 8),
-)
-```
-
-## Analysis Features
-
-```python
-# Geographic distribution stats
-stats = cmap.get_stats()
-
-print("\nTop countries:")
-for country, count in stats.top_countries[:10]:
-    print(f"  {country}: {count} citations")
-
-print("\nTop institutions:")
-for inst, count in stats.top_institutions[:10]:
-    print(f"  {inst}: {count} citations")
-
-print("\nContinental distribution:")
-for continent, pct in stats.continental_distribution.items():
-    print(f"  {continent}: {pct:.1f}%")
-```
-
-## Time Evolution
-
-```python
-# Animate citation spread over time
-cmap.plot_animated(
-    output="citation_evolution.html",
-    time_field="year",
-    interval=1000,  # ms per year
-    cumulative=True,
-)
-
-# Year-by-year breakdown
-for year in range(2020, 2026):
-    year_stats = cmap.filter_by_year(year)
-    print(f"{year}: {year_stats.count} citations, "
-          f"{year_stats.countries} countries")
-```
-
-## Paper-Specific Maps
-
-```python
-# Map for a specific paper
-cmap.plot_map(
-    paper_title="Your Specific Paper Title",
-    output="paper_citations.html",
-    style="markers",
-)
-
-# Compare papers
-papers = cmap.get_papers()
-for paper in papers[:5]:
-    print(f"\n{paper.title} ({paper.year})")
-    print(f"  Citations: {paper.citation_count}")
-    print(f"  Countries: {paper.country_count}")
-```
-
-## Export
-
-```python
-# Export citation data
-cmap.export_csv("citations.csv")
-# Columns: citing_author, affiliation, country, lat, lon,
-#           citing_paper, cited_paper, year
-
-# Export for GIS software
-cmap.export_geojson("citations.geojson")
-
-# Export summary statistics
-cmap.export_report("citation_report.md")
-```
-
-## Configuration
-
-```python
-cmap = CitationMap(
-    scholar_id="YOUR_ID",
-    config={
-        "geocoding_service": "nominatim",  # or "google"
-        "cache_dir": ".citationmap_cache",
-        "rate_limit": 1.0,  # seconds between API calls
-        "affiliation_parsing": "heuristic",  # or "llm"
-    },
-)
-```
-
-## Use Cases
-
-1. **CV enhancement**: Show global research impact visually
-2. **Grant applications**: Demonstrate international reach
-3. **Department reports**: Aggregate maps for research groups
-4. **Collaboration discovery**: Find active citing institutions
-5. **Impact assessment**: Geographic diversity of citations
-
-## References
-
-- [CitationMap GitHub](https://github.com/ChenLiu-1996/CitationMap)
-- [Google Scholar](https://scholar.google.com/)
-- [Folium](https://python-visualization.github.io/folium/) — Map rendering

package/skills/analysis/dataviz/data-visualization-principles/SKILL.md

@@ -1,171 +0,0 @@
----
-name: data-visualization-principles
-description: "Design principles for creating effective and honest data visualizations"
-metadata:
-  openclaw:
-    emoji: "📊"
-    category: "analysis"
-    subcategory: "dataviz"
-    keywords: ["data visualization", "chart design", "visual encoding", "chart selection", "color theory", "publication figures"]
-    source: "https://clawhub.ai/data-visualization"
----
-
-# Data Visualization Design Principles
-
-## Overview
-
-Effective data visualization reveals patterns, communicates findings, and supports evidence-based arguments. Poor visualization obscures or misleads. This guide covers the fundamental principles of visual encoding, chart type selection, color usage, and common pitfalls — applicable to any plotting tool (matplotlib, ggplot2, Stata, Excel, D3.js).
-
-## Visual Encoding Hierarchy
-
-Not all visual channels are created equal. Humans perceive some encodings more accurately than others:
-
-```
-Most accurate (use for primary comparisons):
-  1. Position on a common scale (bar chart, dot plot)
-  2. Position on non-aligned scales (small multiples)
-  3. Length (bar chart)
-  4. Angle / Slope (line chart trends)
-
-Moderately accurate:
-  5. Area (bubble chart — but easily misjudged)
-  6. Volume (3D — almost always misleading, avoid)
-  7. Color saturation / luminance (heatmap)
-
-Least accurate (use for categorical grouping only):
-  8. Color hue (distinguishing categories, not quantities)
-  9. Shape (point markers — circle vs. triangle)
-  10. Texture / Pattern (rarely useful)
-```
-
-**Implication**: Encode your most important comparison as position, not as color or area.
-
-## Chart Selection Guide
-
-| Data Relationship | Best Chart | Avoid |
-|-------------------|-----------|-------|
-| **Compare values** across categories | Bar chart (horizontal for many categories) | Pie chart (hard to compare slices) |
-| **Show distribution** of one variable | Histogram, density plot, box plot | Bar chart of means (hides distribution) |
-| **Compare distributions** across groups | Violin plot, ridgeline plot, strip plot | Multiple overlapping histograms |
-| **Show trend** over time | Line chart | Bar chart (for continuous time) |
-| **Show relationship** between 2 variables | Scatter plot | Line chart (implies ordering) |
-| **Show composition** (parts of whole) | Stacked bar (absolute) or 100% bar (relative) | Pie chart, 3D pie chart |
-| **Show correlation matrix** | Heatmap with numbers | Scatter matrix (too many panels) |
-| **Compare many metrics** per item | Radar chart (sparingly), parallel coordinates | Multiple bar charts |
-| **Show geographic patterns** | Choropleth map, dot map | 3D terrain maps |
-| **Show network structure** | Node-edge graph, adjacency matrix | Overly dense hairball graphs |
-
-## Design Rules
-
-### Rule 1: Maximize Data-Ink Ratio
-
-Remove everything that doesn't communicate data:
-
-```
-Remove:
-  ✗ Background grid (or make very light gray)
-  ✗ 3D effects on 2D data
-  ✗ Decorative elements (clipart, unnecessary icons)
-  ✗ Redundant legends (if only one series)
-  ✗ Box around the plot (chart junk)
-
-Keep:
-  ✓ Data points / bars / lines
-  ✓ Axis labels with units
-  ✓ Title that states the finding (not just "Figure 1")
-  ✓ Direct labels on data (instead of legend when possible)
-```
-
-### Rule 2: Start Y-Axis at Zero (for Bar Charts)
-
-```
-Bar chart: ALWAYS start at 0 (bars encode length)
-Line chart: Starting at 0 is optional (lines encode slope/trend)
-Exception: If all values are close (e.g., 98-102), show the relevant range
-           but clearly mark the broken axis
-```
-
-### Rule 3: Use Informative Titles
-
-```
-Bad:  "Figure 3: Results"
-Bad:  "Figure 3: Accuracy by Method"
-Good: "Figure 3: Our method improves accuracy by 12% over the best baseline"
-Best: "Our method (BERT-RAG) achieves 89.2% accuracy, outperforming
-       all baselines on the SQuAD benchmark"
-```
-
-### Rule 4: Color Usage
-
-```python
-# Qualitative palette (categorical data — 2-8 categories)
-# Use colorblind-friendly palettes
-CATEGORICAL = ['#4477AA', '#EE6677', '#228833', '#CCBB44',
-               '#66CCEE', '#AA3377', '#BBBBBB']
-
-# Sequential palette (ordered data — low to high)
-# Single hue, varying lightness
-# Use: matplotlib "viridis", "plasma", "cividis"
-
-# Diverging palette (data with meaningful center point)
-# Two hues diverging from neutral center
-# Use: "RdBu" (red-blue), "BrBG" (brown-teal)
-
-# Rules:
-# - Maximum 7 colors for categorical data
-# - Never use rainbow (perceptually non-uniform)
-# - Test in grayscale: can you still distinguish?
-# - Red-green colorblindness affects ~8% of men
-```
-
-## Publication-Ready Formatting
-
-```python
-import matplotlib.pyplot as plt
-
-# Publication-quality defaults
-plt.rcParams.update({
-    'font.family': 'sans-serif',
-    'font.sans-serif': ['Arial', 'Helvetica'],
-    'font.size': 10,
-    'axes.labelsize': 11,
-    'axes.titlesize': 12,
-    'xtick.labelsize': 9,
-    'ytick.labelsize': 9,
-    'legend.fontsize': 9,
-    'figure.dpi': 300,
-    'savefig.dpi': 300,
-    'savefig.bbox': 'tight',
-    'axes.spines.top': False,      # Remove top spine
-    'axes.spines.right': False,    # Remove right spine
-    'lines.linewidth': 1.5,
-    'axes.linewidth': 0.8,
-})
-
-# Single column figure (journal standard: 85mm ≈ 3.35in)
-fig, ax = plt.subplots(figsize=(3.35, 2.5))
-
-# Double column figure (170mm ≈ 6.7in)
-fig, axes = plt.subplots(1, 2, figsize=(6.7, 2.5))
-```
-
-## Common Mistakes
-
-| Mistake | Why It's Wrong | Fix |
-|---------|---------------|-----|
-| Pie chart for comparison | Humans are bad at comparing angles | Use bar chart |
-| 3D bar chart | 3D perspective distorts bar heights | Use 2D bars |
-| Dual y-axes | Misleading — scale choice changes the story | Two separate panels |
-| Truncated y-axis on bar chart | Exaggerates differences | Start at 0 |
-| Too many colors | Cognitive overload | Max 7 categories; group the rest as "Other" |
-| Low resolution figures | Blurry in print | Export at 300 DPI minimum |
-| Missing units | "What does the y-axis mean?" | Always label with units |
-| Legend far from data | Reader must scan back and forth | Direct label the data |
-
-## References
-
-- Tufte, E. R. (2001). *The Visual Display of Quantitative Information*. Graphics Press.
-- Wilke, C. O. (2019). *Fundamentals of Data Visualization*. O'Reilly.
-- Rougier, N. P., et al. (2014). "Ten Simple Rules for Better Figures." *PLOS Computational Biology*, 10(9).
-- [ColorBrewer 2.0](https://colorbrewer2.org/)
-- [Datawrapper Blog](https://blog.datawrapper.de/) — Excellent chart design advice