@wentorai/research-plugins 1.0.0

package/skills/research/funding/figshare-api/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: figshare-api
+description: "Research data sharing and repository"
+metadata:
+  openclaw:
+    emoji: "🔍"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["open data", "data sharing", "data archiving", "FAIR data principles", "open source code"]
+    source: "https://docs.figshare.com/"
+    requires:
+      env: ["FIGSHARE_API_TOKEN"]
+---
+
+# Figshare API Guide
+
+## Overview
+
+Figshare is a cloud-based research data management platform that allows researchers to store, share, and discover research outputs including datasets, figures, media, papers, posters, and fileset collections. Every item uploaded to Figshare receives a citable DOI and is stored in a FAIR-compliant manner, making research outputs findable, accessible, interoperable, and reusable.
+
+The Figshare API provides comprehensive programmatic access to the repository, enabling researchers and institutions to automate data publishing, integrate with research workflows, and build custom discovery interfaces. The platform supports versioning, embargo periods, and flexible access controls for both public and private research data.
+
+Researchers, data managers, institutional repository administrators, and research infrastructure developers use the Figshare API to automate deposit workflows, harvest metadata for institutional dashboards, build data discovery tools, and integrate research data management into existing laboratory information management systems. Figshare serves over 150 institutions worldwide and hosts millions of research outputs.
+
+## Authentication
+
+Authentication via personal access token is required for write operations and accessing private content. Read access to public content is available without authentication but has lower rate limits.
+
+1. Log in to Figshare at https://figshare.com/
+2. Navigate to **Applications** in your account settings
+3. Create a **Personal Token** with desired permissions
+4. Include the token in the `Authorization` header
+
+```bash
+curl -H "Authorization: token YOUR_FIGSHARE_TOKEN" "https://api.figshare.com/v2/account/articles"
+```
+
+Public endpoints can be accessed without a token for browsing published content.
+
+## Core Endpoints
+
+### articles: Search and Retrieve Articles
+
+Search the public Figshare repository for published articles (datasets, figures, papers, media, and other item types).
+
+- **URL**: `GET https://api.figshare.com/v2/articles`
+- **Parameters**:
+
+| Parameter      | Type   | Required | Description                                            |
+|----------------|--------|----------|--------------------------------------------------------|
+| search_for     | string | No       | Free-text search query                                 |
+| item_type      | int    | No       | Item type filter (1=figure, 2=media, 3=dataset, etc.)  |
+| published_since| string | No       | Filter by date (YYYY-MM-DD format)                     |
+| order          | string | No       | Sort: `published_date`, `modified_date`, `views`       |
+| order_direction| string | No       | `asc` or `desc`                                        |
+| page           | int    | No       | Page number (default 1)                                |
+| page_size      | int    | No       | Results per page (default 10, max 1000)                |
+
+- **Example**:
+
+```bash
+curl -X POST "https://api.figshare.com/v2/articles/search" \
+  -H "Content-Type: application/json" \
+  -d '{"search_for": "genomics CRISPR", "item_type": 3, "page_size": 5}'
+```
+
+- **Response**: Returns array of article objects with `id`, `title`, `doi`, `url`, `published_date`, `description`, `defined_type_name`, `categories`, `tags`, `authors`, `files` (with download URLs), and `citation`.
+
+### datasets: Manage Research Datasets
+
+Retrieve and manage dataset-specific content in Figshare. Datasets are a specialized article type with additional support for large file collections.
+
+- **URL**: `GET https://api.figshare.com/v2/articles/{article_id}`
+- **Parameters**:
+
+| Parameter  | Type | Required | Description                        |
+|------------|------|----------|------------------------------------|
+| article_id | int  | Yes      | The Figshare article/dataset ID    |
+
+- **Example**:
+
+```bash
+# Get a specific dataset by ID
+curl "https://api.figshare.com/v2/articles/12345678"
+
+# List files in a dataset
+curl "https://api.figshare.com/v2/articles/12345678/files"
+```
+
+- **Response**: Returns complete article object with `id`, `title`, `doi`, `description`, `authors`, `categories`, `tags`, `files` (array with `name`, `size`, `download_url`, `computed_md5`), `license`, `version`, `is_embargoed`, and `custom_fields`.
+
+## Rate Limits
+
+Rate limits vary based on authentication status and endpoint. Authenticated requests generally allow up to 100 requests per minute. Unauthenticated requests are limited to approximately 10 requests per minute. The API returns HTTP 429 with a `Retry-After` header when limits are exceeded. For bulk data harvesting, Figshare provides OAI-PMH endpoints at `https://api.figshare.com/v2/oai` which are more suitable for large-scale metadata collection.
+
+## Common Patterns
+
+### Search for Datasets in a Research Area
+
+Find publicly available datasets matching specific research topics:
+
+```python
+import requests
+
+payload = {
+    "search_for": "single cell RNA-seq",
+    "item_type": 3,  # datasets only
+    "page_size": 20,
+    "order": "published_date",
+    "order_direction": "desc"
+}
+
+resp = requests.post("https://api.figshare.com/v2/articles/search", json=payload)
+results = resp.json()
+
+for item in results:
+    print(f"{item['title']}")
+    print(f"  DOI: {item['doi']}")
+    print(f"  Published: {item['published_date']}")
+    print()
+```
+
+### Upload a Dataset Programmatically
+
+Automate data deposit for reproducible research workflows:
+
+```python
+import requests
+
+TOKEN = os.environ["FIGSHARE_API_TOKEN"]
+headers = {"Authorization": f"token {TOKEN}", "Content-Type": "application/json"}
+
+# Step 1: Create a new article
+article_data = {
+    "title": "Supplementary Data for Analysis of Gene Expression",
+    "defined_type": "dataset",
+    "description": "RNA-seq counts and metadata for the analysis.",
+    "tags": ["RNA-seq", "gene expression"],
+    "categories": [69]  # Genetics category
+}
+resp = requests.post("https://api.figshare.com/v2/account/articles",
+                     headers=headers, json=article_data)
+article_url = resp.json()["location"]
+
+# Step 2: Upload file
+article = requests.get(article_url, headers=headers).json()
+print(f"Created article ID: {article['id']}, DOI will be assigned on publish")
+```
+
+### Harvest Institutional Outputs via OAI-PMH
+
+Collect metadata from all Figshare items in an institution's repository:
+
+```bash
+curl "https://api.figshare.com/v2/oai?verb=ListRecords&metadataPrefix=oai_dc&set=institution_123"
+```
+
+## References
+
+- Official API documentation: https://docs.figshare.com/
+- Figshare homepage: https://figshare.com/
+- API endpoint reference: https://docs.figshare.com/#figshare_documentation_api_description
+- OAI-PMH endpoint: https://docs.figshare.com/#oai_pmh

package/skills/research/funding/grant-writing-guide/SKILL.md

@@ -0,0 +1,233 @@
+---
+name: grant-writing-guide
+description: "Write competitive research proposals with clear objectives and budgets"
+metadata:
+  openclaw:
+    emoji: "moneybag"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["research proposal writing", "grant proposal", "grant writing", "budget planning", "funding application"]
+    source: "wentor"
+---
+
+# Grant Writing Guide
+
+A skill for preparing competitive research grant proposals. Covers proposal structure, writing strategies, budget preparation, and common evaluation criteria used by major funding agencies (NSF, NIH, ERC, NSFC).
+
+## Proposal Structure
+
+### Generic Proposal Template
+
+Most funding agencies require these core components:
+
+```
+1. Cover Page / Project Summary (1 page)
+   - Title (concise, descriptive, no jargon)
+   - PI name, institution, co-PIs
+   - Total budget and duration
+   - Abstract (250 words)
+   - Keywords (5-8)
+
+2. Project Description / Research Plan (10-15 pages typically)
+   a. Introduction and Background
+   b. Specific Aims / Research Questions
+   c. Research Design and Methods
+   d. Timeline and Milestones
+   e. Expected Outcomes and Significance
+   f. Broader Impacts (NSF) / Societal Relevance
+
+3. Literature Cited / References
+
+4. Budget and Budget Justification
+
+5. Biographical Sketches / CVs
+
+6. Data Management Plan
+
+7. Facilities and Equipment
+
+8. Supplementary Materials (letters of support, etc.)
+```
+
+## Writing the Specific Aims
+
+### The Critical First Page
+
+The specific aims page is the most important page of any NIH-style proposal. Reviewers often form their opinion based on this page alone.
+
+```python
+def specific_aims_template(project_info: dict) -> str:
+    """
+    Generate a specific aims page structure.
+
+    Args:
+        project_info: Dict with 'problem', 'gap', 'approach', 'aims', 'impact'
+    """
+    template = f"""
+SPECIFIC AIMS
+
+[Opening paragraph: The big picture problem]
+{project_info['problem']}
+
+[Gap paragraph: What is unknown/unsolved]
+{project_info['gap']}
+
+[Approach paragraph: What will you do and why]
+{project_info['approach']}
+
+The long-term goal of this research is [long-term vision].
+The objective of this proposal is [specific objective].
+The central hypothesis is [testable hypothesis],
+based on [preliminary data / rationale].
+
+The following specific aims will test this hypothesis:
+
+Aim 1: {project_info['aims'][0]['title']}
+  {project_info['aims'][0]['description']}
+  Hypothesis: {project_info['aims'][0]['hypothesis']}
+
+Aim 2: {project_info['aims'][1]['title']}
+  {project_info['aims'][1]['description']}
+  Hypothesis: {project_info['aims'][1]['hypothesis']}
+
+[Impact paragraph]
+{project_info['impact']}
+"""
+    return template
+```
+
+## Budget Preparation
+
+### Common Budget Categories
+
+```python
+def create_budget(personnel: list[dict], equipment: list[dict],
+                   travel: list[dict], other: list[dict],
+                   indirect_rate: float = 0.55,
+                   years: int = 3) -> dict:
+    """
+    Create a research budget with indirect costs.
+
+    Args:
+        personnel: List of {'role', 'salary', 'effort_pct', 'fringe_rate'}
+        equipment: List of {'item', 'cost'}
+        travel: List of {'purpose', 'cost_per_year'}
+        other: List of {'item', 'cost_per_year'}
+        indirect_rate: F&A rate (decimal)
+        years: Project duration in years
+    """
+    budget = {'years': {}}
+
+    for year in range(1, years + 1):
+        year_budget = {'categories': {}}
+
+        # Personnel (with annual salary increases of 3%)
+        personnel_total = 0
+        for person in personnel:
+            salary = person['salary'] * (1.03 ** (year - 1))
+            cost = salary * person['effort_pct'] / 100
+            fringe = cost * person['fringe_rate']
+            personnel_total += cost + fringe
+
+        year_budget['categories']['personnel'] = round(personnel_total)
+
+        # Equipment (Year 1 only for major items)
+        equip_total = sum(e['cost'] for e in equipment) if year == 1 else 0
+        year_budget['categories']['equipment'] = equip_total
+
+        # Travel
+        travel_total = sum(t['cost_per_year'] for t in travel)
+        year_budget['categories']['travel'] = travel_total
+
+        # Other direct costs
+        other_total = sum(o['cost_per_year'] for o in other)
+        year_budget['categories']['other'] = other_total
+
+        # Modified total direct costs (MTDC excludes equipment >$5000)
+        mtdc = personnel_total + travel_total + other_total
+        if equip_total < 5000:
+            mtdc += equip_total
+
+        # Indirect costs
+        indirect = mtdc * indirect_rate
+        year_budget['categories']['indirect'] = round(indirect)
+
+        year_budget['direct_total'] = round(
+            personnel_total + equip_total + travel_total + other_total
+        )
+        year_budget['total'] = round(
+            year_budget['direct_total'] + indirect
+        )
+
+        budget['years'][year] = year_budget
+
+    budget['grand_total'] = sum(y['total'] for y in budget['years'].values())
+    return budget
+
+# Example budget
+budget = create_budget(
+    personnel=[
+        {'role': 'PI', 'salary': 120000, 'effort_pct': 20, 'fringe_rate': 0.30},
+        {'role': 'Postdoc', 'salary': 56000, 'effort_pct': 100, 'fringe_rate': 0.25},
+        {'role': 'PhD Student', 'salary': 34000, 'effort_pct': 50, 'fringe_rate': 0.10}
+    ],
+    equipment=[{'item': 'GPU server', 'cost': 15000}],
+    travel=[{'purpose': 'Conference attendance', 'cost_per_year': 3000}],
+    other=[
+        {'item': 'Publication charges', 'cost_per_year': 2000},
+        {'item': 'Cloud computing', 'cost_per_year': 5000}
+    ],
+    indirect_rate=0.55,
+    years=3
+)
+```
+
+## Evaluation Criteria by Agency
+
+### NSF Review Criteria
+
+| Criterion | Weight | Key Questions |
+|-----------|--------|---------------|
+| Intellectual Merit | ~50% | Does it advance knowledge? Is the approach sound? |
+| Broader Impacts | ~50% | Societal benefit? Education? Diversity? Infrastructure? |
+
+### NIH Review Criteria (Scored 1-9)
+
+| Criterion | Key Questions |
+|-----------|---------------|
+| Significance | Does it address an important problem? |
+| Investigator(s) | Are PI and team qualified? |
+| Innovation | Novel approaches or concepts? |
+| Approach | Is the strategy well-reasoned and feasible? |
+| Environment | Does the institution support the work? |
+
+## Timeline and Milestones
+
+### Gantt Chart Data Structure
+
+```python
+def create_project_timeline(aims: list[dict], total_months: int = 36) -> list[dict]:
+    """Create a project timeline for a grant proposal."""
+    timeline = []
+    for aim in aims:
+        for task in aim['tasks']:
+            timeline.append({
+                'aim': aim['name'],
+                'task': task['name'],
+                'start_month': task['start'],
+                'end_month': task['end'],
+                'milestone': task.get('milestone', ''),
+                'deliverable': task.get('deliverable', '')
+            })
+    return timeline
+```
+
+## Common Mistakes to Avoid
+
+1. **Overly ambitious scope**: Reviewers can tell when 3 years of funding is covering 10 years of work
+2. **Weak preliminary data**: Show feasibility with pilot results
+3. **Vague methods**: Specify exact techniques, sample sizes, and analysis plans
+4. **Missing contingency plans**: Address "what if" scenarios for risky approaches
+5. **Budget-narrative mismatch**: Every budget item must connect to the research plan
+6. **Late submission**: Submit at least 24 hours before the deadline to avoid system crashes
+7. **Ignoring reviewer feedback**: If resubmitting, address every prior critique explicitly

package/skills/research/funding/nsf-grant-guide/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: nsf-grant-guide
+description: "Navigate NSF grant applications, program selection, and strategies"
+metadata:
+  openclaw:
+    emoji: "moneybag"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["NSF grant", "grant writing", "funding", "research proposal", "broader impacts", "NSF program"]
+    source: "wentor-research-plugins"
+---
+
+# NSF Grant Guide
+
+A skill for navigating the National Science Foundation (NSF) grant application process. Covers program selection, proposal structure, the dual review criteria (Intellectual Merit and Broader Impacts), budget preparation, and strategies for improving funding success.
+
+## NSF Proposal Structure
+
+### Required Sections
+
+```
+1. Cover Sheet (generated by Research.gov/FastLane)
+2. Project Summary (1 page max)
+   - Overview
+   - Intellectual Merit statement
+   - Broader Impacts statement
+3. Project Description (15 pages max for most programs)
+   - Introduction and background
+   - Proposed research plan
+   - Broader impacts plan
+   - Timeline and milestones
+4. References Cited (no page limit)
+5. Budget and Budget Justification
+6. Biographical Sketches (3 pages per PI/co-PI)
+7. Current and Pending Support
+8. Data Management Plan (2 pages max)
+9. Facilities, Equipment, and Other Resources
+10. Supplementary Documents (letters of collaboration, etc.)
+```
+
+### Project Summary Template
+
+```
+Project Summary (1 page, three separate sections):
+
+Overview:
+  "This project will [what you will do] to address [problem].
+   We propose [approach/method] that will [expected outcome].
+   The work will be conducted over [duration] at [institution]."
+
+Intellectual Merit:
+  "The intellectual merit of this project lies in [contribution
+   to knowledge]. Specifically, this work will advance understanding
+   of [topic] by [how]. The proposed approach is innovative because
+   [novelty]. The PI has expertise in [relevant qualifications]."
+
+Broader Impacts:
+  "The broader impacts include [societal benefits]. Specifically,
+   the project will [education component, broadening participation,
+   infrastructure, dissemination, or societal benefit]. These
+   activities will benefit [who] by [how]."
+```
+
+## Intellectual Merit and Broader Impacts
+
+### The Two Review Criteria
+
+```python
+def evaluate_merit_criteria() -> dict:
+    """
+    NSF's two merit review criteria and their elements.
+    """
+    return {
+        "intellectual_merit": {
+            "definition": (
+                "The potential to advance knowledge within and across "
+                "fields of science and engineering."
+            ),
+            "elements_reviewers_consider": [
+                "What is the potential for the proposed activity to advance "
+                "knowledge and understanding within its own field or across fields?",
+                "To what extent does the proposed activity suggest and explore "
+                "creative, original, or potentially transformative concepts?",
+                "Is the plan for carrying out the proposed activities well-reasoned, "
+                "well-organized, and based on a sound rationale?",
+                "How well qualified is the individual, team, or organization to "
+                "conduct the proposed activities?",
+                "Are there adequate resources available?"
+            ]
+        },
+        "broader_impacts": {
+            "definition": (
+                "The potential to benefit society and contribute to the "
+                "achievement of specific, desired societal outcomes."
+            ),
+            "examples": [
+                "Training and mentoring students (especially underrepresented groups)",
+                "Curriculum development and educational outreach",
+                "Public engagement with science and technology",
+                "Partnerships with industry, government, or community organizations",
+                "Infrastructure for research and education",
+                "Broadening participation of underrepresented groups in STEM"
+            ],
+            "common_mistake": (
+                "Do not treat broader impacts as an afterthought. "
+                "Reviewers and panels weight this criterion equally with "
+                "intellectual merit."
+            )
+        }
+    }
+```
+
+## Finding the Right Program
+
+### Program Selection Strategy
+
+```
+1. Browse NSF Directorates and Divisions:
+   - BIO (Biological Sciences)
+   - CISE (Computer & Information Science & Engineering)
+   - ENG (Engineering)
+   - GEO (Geosciences)
+   - MPS (Mathematical & Physical Sciences)
+   - SBE (Social, Behavioral & Economic Sciences)
+   - EDU (STEM Education)
+
+2. Use NSF Award Search (nsf.gov/awardsearch):
+   - Search by keyword to find funded projects similar to yours
+   - Note which program funded them
+
+3. Read program solicitations carefully:
+   - Check eligibility requirements
+   - Note submission deadlines (some are annual, some rolling)
+   - Check page limits and special requirements
+
+4. Contact the Program Director:
+   - Send a 1-page summary of your idea
+   - Ask if it fits the program scope
+   - This is expected and encouraged by NSF
+```
+
+## Budget Preparation
+
+### Common Budget Categories
+
+```
+A. Senior Personnel:
+   - PI and co-PI salary and fringe benefits
+   - Summer months for academic-year faculty (typically 1-2 months)
+
+B. Other Personnel:
+   - Graduate research assistants (stipend + tuition)
+   - Postdoctoral researchers
+   - Undergraduate students (REU supplements available)
+   - Technical staff
+
+C. Fringe Benefits:
+   - Rates set by your institution's sponsored programs office
+
+D. Equipment:
+   - Items over $5,000 (institution-specific threshold)
+
+E. Travel:
+   - Domestic and international conference travel
+   - Fieldwork travel
+
+F. Other Direct Costs:
+   - Materials and supplies
+   - Publication costs
+   - Participant support (stipends for workshop attendees)
+   - Subawards to collaborating institutions
+
+G. Indirect Costs (F&A):
+   - Negotiated rate between your institution and the federal government
+   - Typically 50-60% of modified total direct costs
+```
+
+## Tips for Competitive Proposals
+
+### What Panel Reviewers Look For
+
+```
+1. Clear, specific research questions (not vague goals)
+2. Feasibility: Can this actually be done in the proposed time?
+3. Preliminary results that demonstrate competence and viability
+4. Well-integrated broader impacts (not bolted on)
+5. Appropriate budget (neither padded nor unrealistic)
+6. Strong team with complementary expertise
+7. Awareness of potential pitfalls and contingency plans
+```
+
+### Common Reasons for Rejection
+
+```
+- Research plan is too ambitious or too incremental
+- Broader impacts are vague or disconnected from the research
+- Insufficient preliminary data to justify the approach
+- Writing is unclear, disorganized, or hard to follow
+- Budget is poorly justified
+- Wrong program (proposal does not match the solicitation)
+- Missing required elements (data management plan, etc.)
+```
+
+## Timeline
+
+Start preparing at least 3-4 months before the deadline. Allow 2 weeks for institutional review and submission through Research.gov. Request letters of collaboration early. Have colleagues outside your subfield review a draft for clarity. Most successful PIs submit revised versions of previously declined proposals, so treat a rejection as feedback for the next submission.