@wentorai/research-plugins 1.1.0 → 1.2.0

package/skills/literature/search/share-research-api/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: share-research-api
+description: "Discover open access research outputs via the SHARE notification API"
+metadata:
+  openclaw:
+    emoji: "📢"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["SHARE", "open access", "research notification", "COS", "repository aggregator", "preprints"]
+    source: "https://share.osf.io/"
+---
+
+# SHARE Research API
+
+## Overview
+
+SHARE (SHared Access Research Ecosystem) aggregates metadata from 200+ research repositories, preprint servers, and publishers into a unified search API. Operated by the Center for Open Science, it tracks research outputs as they move through the scholarly communication cycle — from preprint to publication. Free, no authentication for search.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://share.osf.io/api/v2
+```
+
+### Search
+
+```bash
+# Text search across all sources
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=climate+change&page[size]=20"
+
+# Filter by type
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=neural+networks&filter[type]=preprint"
+
+# Filter by source
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=genomics&filter[sources]=PubMed+Central"
+
+# Filter by date
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=COVID-19&filter[date][gte]=2024-01-01"
+
+# Filter by tag/subject
+curl "https://share.osf.io/api/v2/search/creativeworks/?q=machine+learning&filter[tags]=deep+learning"
+```
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `q` | Search query | `q=CRISPR` |
+| `filter[type]` | Output type | `preprint`, `article`, `dataset`, `thesis` |
+| `filter[sources]` | Source repository | `PubMed Central`, `arXiv`, `Zenodo` |
+| `filter[date][gte]` | From date | `2024-01-01` |
+| `filter[date][lte]` | Until date | `2026-12-31` |
+| `filter[tags]` | Tag filter | `open+data` |
+| `page[size]` | Results per page | `page[size]=50` |
+| `sort` | Sort order | `-date_updated` |
+
+### Available Sources (200+)
+
+| Source | Type |
+|--------|------|
+| arXiv | Preprints |
+| PubMed Central | Biomedical articles |
+| Zenodo | Multi-discipline repository |
+| Figshare | Data/figures |
+| SSRN | Social science preprints |
+| DataCite | Research data |
+| Institutional repositories | Various |
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://share.osf.io/api/v2"
+
+
+def search_share(query: str, output_type: str = None,
+                 source: str = None,
+                 from_date: str = None,
+                 page_size: int = 20) -> list:
+    """Search SHARE for research outputs."""
+    params = {"q": query, "page[size]": page_size}
+    if output_type:
+        params["filter[type]"] = output_type
+    if source:
+        params["filter[sources]"] = source
+    if from_date:
+        params["filter[date][gte]"] = from_date
+
+    resp = requests.get(
+        f"{BASE_URL}/search/creativeworks/",
+        params=params,
+    )
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for item in data.get("data", []):
+        attrs = item.get("attributes", {})
+        results.append({
+            "title": attrs.get("title"),
+            "description": (attrs.get("description") or "")[:300],
+            "type": attrs.get("type"),
+            "date": attrs.get("date_updated", "")[:10],
+            "sources": attrs.get("sources", []),
+            "tags": attrs.get("tags", []),
+            "identifiers": attrs.get("identifiers", []),
+        })
+    return results
+
+
+# Example: find recent preprints on a topic
+preprints = search_share(
+    "transformer architecture",
+    output_type="preprint",
+    from_date="2024-01-01",
+)
+for p in preprints[:5]:
+    print(f"[{p['date']}] {p['title']}")
+    print(f"  Type: {p['type']} | Sources: {', '.join(p['sources'][:3])}")
+```
+
+## References
+
+- [SHARE](https://share.osf.io/)
+- [SHARE API Documentation](https://share.osf.io/api/v2/)
+- [Center for Open Science](https://cos.io/)

package/skills/literature/search/worldcat-search-api/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: worldcat-search-api
+description: "Search the world's largest library catalog via OCLC WorldCat API"
+metadata:
+  openclaw:
+    emoji: "🏛️"
+    category: "literature"
+    subcategory: "search"
+    keywords: ["worldcat", "library catalog", "OCLC", "book search", "holdings", "interlibrary loan"]
+    source: "https://developer.api.oclc.org/"
+---
+
+# WorldCat Search API
+
+## Overview
+
+WorldCat is the world's largest network of library content, aggregating catalogs from 10,000+ libraries across 170+ countries. The Search API provides access to 500M+ bibliographic records — books, journals, dissertations, media, and more — with holdings information showing which libraries own each item. Essential for interlibrary loan discovery, collection analysis, and comprehensive bibliographic searches. Requires a WSKey (free for non-commercial use).
+
+## Authentication
+
+```bash
+# Register at https://platform.worldcat.org/
+# Obtain a WSKey (API key) for your application
+
+# OAuth 2.0 client credentials flow
+curl -X POST "https://oauth.oclc.org/token" \
+  -u "$WSKEY_CLIENT_ID:$WSKEY_SECRET" \
+  -d "grant_type=client_credentials&scope=wcapi"
+```
+
+## API Endpoints
+
+### Base URL
+
+```
+https://www.worldcat.org/api/search/
+```
+
+### Search Bibliographic Records
+
+```bash
+# Keyword search
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=machine+learning&limit=25"
+
+# Search by title
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=ti:attention+is+all+you+need"
+
+# Search by author
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=au:hinton+geoffrey"
+
+# Search by ISBN
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=bn:9780262035613"
+
+# Combined filters
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search?q=su:artificial+intelligence+AND+yr:2020-2026&itemType=book"
+```
+
+### Search Indexes
+
+| Index | Prefix | Example |
+|-------|--------|---------|
+| Keyword | (none) | `q=neural+networks` |
+| Title | `ti:` | `q=ti:deep+learning` |
+| Author | `au:` | `q=au:goodfellow` |
+| Subject | `su:` | `q=su:machine+learning` |
+| ISBN | `bn:` | `q=bn:9780262035613` |
+| ISSN | `n:` | `q=n:0028-0836` |
+| OCLC Number | `no:` | `q=no:1234567` |
+| Publisher | `pb:` | `q=pb:MIT+Press` |
+| Year | `yr:` | `q=yr:2024` or `yr:2020-2026` |
+| Language | `la:` | `q=la:eng` |
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `q` | Search query with indexes | `q=ti:BERT+AND+au:devlin` |
+| `limit` | Results per page (max 50) | `limit=25` |
+| `offset` | Pagination offset | `offset=50` |
+| `itemType` | Format filter | `book`, `journal`, `thesis`, `audiobook` |
+| `itemSubType` | Subtype filter | `digital`, `printbook` |
+| `heldByInstitutionID` | Holdings filter | Institution registry ID |
+| `orderBy` | Sort order | `bestMatch`, `mostWidelyHeld`, `datePublished` |
+
+### Get Record by OCLC Number
+
+```bash
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search/brief-bibs/{oclc_number}"
+```
+
+### Holdings / Library Locations
+
+```bash
+# Find libraries holding a specific item
+curl -H "Authorization: Bearer $TOKEN" \
+  "https://www.worldcat.org/api/search/brief-bibs/{oclc_number}/holdings?lat=42.36&lon=-71.06&distance=50"
+```
+
+## Response Structure
+
+```json
+{
+  "numberOfRecords": 1250,
+  "briefRecords": [
+    {
+      "oclcNumber": "1234567890",
+      "title": "Deep Learning",
+      "creator": "Ian Goodfellow; Yoshua Bengio; Aaron Courville",
+      "date": "2016",
+      "publisher": "MIT Press",
+      "language": "eng",
+      "generalFormat": "Book",
+      "specificFormat": "PrintBook",
+      "isbns": ["9780262035613"],
+      "catalogingInfo": {
+        "catalogingAgency": "DLC"
+      },
+      "totalHoldingCount": 3542
+    }
+  ]
+}
+```
+
+## Python Usage
+
+```python
+import os
+import requests
+
+CLIENT_ID = os.environ["OCLC_WSKEY_ID"]
+CLIENT_SECRET = os.environ["OCLC_WSKEY_SECRET"]
+BASE_URL = "https://www.worldcat.org/api/search"
+
+
+def get_token() -> str:
+    """Obtain OAuth token from OCLC."""
+    resp = requests.post(
+        "https://oauth.oclc.org/token",
+        auth=(CLIENT_ID, CLIENT_SECRET),
+        data={"grant_type": "client_credentials", "scope": "wcapi"},
+    )
+    resp.raise_for_status()
+    return resp.json()["access_token"]
+
+
+def search_worldcat(query: str, limit: int = 25,
+                    item_type: str = None) -> list:
+    """Search WorldCat bibliographic records."""
+    token = get_token()
+    params = {"q": query, "limit": limit}
+    if item_type:
+        params["itemType"] = item_type
+
+    resp = requests.get(
+        BASE_URL,
+        headers={"Authorization": f"Bearer {token}"},
+        params=params,
+    )
+    resp.raise_for_status()
+    data = resp.json()
+
+    results = []
+    for rec in data.get("briefRecords", []):
+        results.append({
+            "oclc": rec.get("oclcNumber"),
+            "title": rec.get("title"),
+            "creator": rec.get("creator"),
+            "date": rec.get("date"),
+            "publisher": rec.get("publisher"),
+            "format": rec.get("generalFormat"),
+            "holdings": rec.get("totalHoldingCount", 0),
+            "isbns": rec.get("isbns", []),
+        })
+    return results
+
+
+def find_nearby_holdings(oclc_number: str,
+                         lat: float, lon: float,
+                         distance_km: int = 50) -> list:
+    """Find libraries near a location that hold a specific item."""
+    token = get_token()
+    resp = requests.get(
+        f"{BASE_URL}/brief-bibs/{oclc_number}/holdings",
+        headers={"Authorization": f"Bearer {token}"},
+        params={"lat": lat, "lon": lon, "distance": distance_km},
+    )
+    resp.raise_for_status()
+    return resp.json().get("briefRecords", [])
+
+
+# Example: find widely-held ML textbooks
+books = search_worldcat("su:machine learning AND yr:2020-2026",
+                        item_type="book", limit=10)
+for b in books:
+    print(f"[{b['date']}] {b['title']} — {b['publisher']} "
+          f"(held by {b['holdings']} libraries)")
+```
+
+## Use Cases
+
+1. **Interlibrary loan**: Find nearest library holding a needed item
+2. **Collection gap analysis**: Compare institutional holdings against a bibliography
+3. **Dissertation discovery**: Search theses across global repositories
+4. **Edition tracking**: Find all editions/translations of a work
+5. **Bibliographic verification**: Confirm ISBNs, publication dates, and publishers
+
+## Access Tiers
+
+| Tier | Access | Rate Limit |
+|------|--------|------------|
+| WSKey (free) | Search + brief records | Moderate |
+| Enterprise | Full MARC records + analytics | Higher |
+
+## References
+
+- [WorldCat Search API Documentation](https://developer.api.oclc.org/)
+- [OCLC Developer Network](https://platform.worldcat.org/)
+- [WorldCat.org](https://www.worldcat.org/)

package/skills/research/automation/aim-experiment-guide/SKILL.md

@@ -4,8 +4,8 @@ description: "Track and compare research experiments with Aim experiment tracker
 metadata:
   openclaw:
     emoji: "🎯"
-    category: research
-    subcategory: automation
+    category: "research"
+    subcategory: "automation"
     keywords: ["experiment-tracking", "visualization", "mlops", "reproducibility", "metrics", "hyperparameters"]
     source: "https://github.com/aimhubio/aim"
 ---

package/skills/research/automation/claude-academic-workflow-guide/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: claude-academic-workflow-guide
+description: "Claude Code template for LaTeX, Beamer, and R research workflows"
+metadata:
+  openclaw:
+    emoji: "📚"
+    category: "research"
+    subcategory: "automation"
+    keywords: ["Claude Code", "academic workflow", "LaTeX", "Beamer", "R", "multi-agent review"]
+    source: "https://github.com/pedrohcgs/claude-code-my-workflow"
+---
+
+# Claude Code Academic Workflow Guide
+
+## Overview
+
+A template and workflow guide for using Claude Code in academic research — managing LaTeX papers, Beamer presentations, R analysis scripts, and multi-agent peer review. Provides structured CLAUDE.md configurations, project templates, and automation patterns for common academic tasks. Designed for economists, social scientists, and quantitative researchers.
+
+## Project Structure
+
+```
+research-project/
+├── CLAUDE.md              # Claude Code instructions
+├── paper/
+│   ├── main.tex           # Main LaTeX document
+│   ├── references.bib     # Bibliography
+│   ├── sections/          # LaTeX sections
+│   └── figures/           # Generated figures
+├── slides/
+│   ├── presentation.tex   # Beamer slides
+│   └── figures/
+├── code/
+│   ├── analysis.R         # Main analysis
+│   ├── data_clean.R       # Data preparation
+│   └── figures.R          # Figure generation
+├── data/
+│   ├── raw/               # Original data
+│   └── processed/         # Cleaned data
+└── output/
+    ├── tables/            # LaTeX tables
+    └── figures/           # PDF/PNG figures
+```
+
+## CLAUDE.md Configuration
+
+```markdown
+# Project: [Your Paper Title]
+
+## Instructions
+- This is an academic research project in economics
+- LaTeX compiler: pdflatex (paper) or xelatex (if CJK)
+- R version: 4.3+ with tidyverse, fixest, ggplot2
+- Citation style: natbib, authoryear
+- Always compile paper after LaTeX changes
+- Run R scripts from project root
+
+## Paper Conventions
+- Use \input{sections/intro} for section includes
+- Tables: booktabs package, generated from R
+- Figures: PDF format, width=\textwidth
+- Cross-refs: \label{sec:}, \label{tab:}, \label{fig:}
+
+## R Conventions
+- Style: tidyverse style guide
+- Data: read from data/processed/
+- Output: tables/ (LaTeX), figures/ (PDF)
+- Reproducibility: set.seed(42) for all random ops
+
+## Build Commands
+- Paper: `cd paper && pdflatex main && bibtex main && pdflatex main && pdflatex main`
+- Slides: `cd slides && pdflatex presentation`
+- Analysis: `cd code && Rscript analysis.R`
+```
+
+## LaTeX Paper Workflow
+
+```bash
+# Claude Code can manage the full LaTeX workflow:
+
+# 1. Draft a section
+# "Write the methodology section for our diff-in-diff analysis"
+
+# 2. Generate tables from R output
+# "Create a LaTeX table from the regression results in output/tables/"
+
+# 3. Fix compilation errors
+# "The paper won't compile — fix the LaTeX errors"
+
+# 4. Update bibliography
+# "Add the Callaway & Sant'Anna (2021) reference"
+
+# 5. Format for submission
+# "Format the paper for AER submission guidelines"
+```
+
+## Beamer Presentations
+
+```latex
+% Template for academic presentations
+\documentclass[aspectratio=169]{beamer}
+\usetheme{metropolis}
+
+\title{Your Presentation Title}
+\subtitle{Conference/Seminar Name}
+\author{Author Name}
+\institute{University}
+\date{\today}
+
+\begin{document}
+\maketitle
+
+\begin{frame}{Motivation}
+\begin{itemize}
+    \item Research question
+    \item Why it matters
+    \item What we do
+\end{itemize}
+\end{frame}
+
+\begin{frame}{Data}
+\input{figures/summary_stats_table}
+\end{frame}
+
+\begin{frame}{Results}
+\centering
+\includegraphics[width=0.8\textwidth]{figures/main_result.pdf}
+\end{frame}
+\end{document}
+```
+
+## R Analysis Integration
+
+```r
+# analysis.R — Main analysis script
+library(tidyverse)
+library(fixest)
+library(modelsummary)
+
+# Load cleaned data
+df <- read_csv("data/processed/analysis_data.csv")
+
+# Main regression
+model1 <- feols(outcome ~ treatment | year + state, data = df)
+model2 <- feols(outcome ~ treatment + controls | year + state,
+                data = df, cluster = ~state)
+
+# Export table for LaTeX
+modelsummary(
+  list("(1)" = model1, "(2)" = model2),
+  output = "output/tables/main_results.tex",
+  stars = c("*" = 0.1, "**" = 0.05, "***" = 0.01),
+  gof_map = c("nobs", "r.squared", "FE: year", "FE: state"),
+)
+
+# Export figure
+ggplot(df, aes(x = year, y = outcome, color = treated)) +
+  geom_point(alpha = 0.3) +
+  geom_smooth(method = "loess") +
+  theme_minimal() +
+  labs(x = "Year", y = "Outcome", color = "Treatment Group")
+ggsave("output/figures/treatment_trends.pdf", width = 8, height = 5)
+```
+
+## Multi-Agent Review
+
+```markdown
+### Self-Review Workflow
+Use Claude Code to simulate peer review:
+
+1. "Review this paper as a critical referee for AER"
+2. "Check all mathematical derivations in section 3"
+3. "Verify that all tables match the R code output"
+4. "Check for consistency between text claims and results"
+5. "List potential referee objections and how to address them"
+```
+
+## Common Tasks
+
+```markdown
+### Things to ask Claude Code:
+- "Compile the paper and fix any errors"
+- "Add robustness check using propensity score matching"
+- "Create a Beamer slide summarizing Table 2"
+- "Generate event study plot from the regression results"
+- "Convert this Word draft to LaTeX format"
+- "Check all cross-references are correct"
+- "Format references in AEA style"
+```
+
+## Use Cases
+
+1. **Paper writing**: LaTeX drafting and compilation workflow
+2. **Data analysis**: R script development and debugging
+3. **Presentations**: Beamer slide creation from paper content
+4. **Self-review**: Multi-agent review simulation
+5. **Submission prep**: Format conversion for journal submission
+
+## References
+
+- [claude-code-my-workflow](https://github.com/pedrohcgs/claude-code-my-workflow)
+- [Metropolis Beamer Theme](https://github.com/matze/mtheme)
+- [modelsummary](https://modelsummary.com/)