@wentorai/research-plugins 1.0.0 → 1.2.0

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

@@ -0,0 +1,284 @@
+---
+name: grant-budget-guide
+description: "Prepare and justify research grant budgets across funding agencies"
+metadata:
+  openclaw:
+    emoji: "money_with_wings"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["grant budget", "budget justification", "cost estimation", "indirect costs", "personnel costs", "funding agencies"]
+    source: "wentor-research-plugins"
+---
+
+# Grant Budget Guide
+
+A skill for preparing realistic, well-justified research grant budgets. Covers common budget categories across major funding agencies (NSF, NIH, ERC, EPSRC, NSERC), cost estimation methods, budget justification writing, common mistakes that trigger reviewer concerns, and strategies for handling budget cuts during negotiation.
+
+## Budget Categories
+
+### Standard Budget Structure
+
+Most funding agencies use similar budget categories, though terminology and rules vary. Understanding the universal structure helps when applying to any funder.
+
+```
+Standard Grant Budget Categories:
+
+1. PERSONNEL (typically 50-70% of total)
+   a. Principal Investigator (PI) salary + benefits
+   b. Co-PI salary + benefits
+   c. Postdoctoral researchers
+   d. Graduate research assistants (stipend + tuition)
+   e. Undergraduate assistants
+   f. Research technicians / lab managers
+   g. Administrative support (if justified)
+
+2. EQUIPMENT (items > agency threshold, e.g., > $5,000)
+   a. Major equipment purchases
+   b. Fabrication costs
+   c. Computer hardware (if specialized)
+   Note: Standard office computers usually NOT allowed
+
+3. TRAVEL
+   a. Domestic conference travel
+   b. International conference travel
+   c. Fieldwork travel
+   d. Collaboration visits
+   e. Per diem and accommodation
+
+4. MATERIALS AND SUPPLIES
+   a. Lab consumables (reagents, chemicals, glassware)
+   b. Software licenses
+   c. Computing costs (cloud, HPC allocations)
+   d. Participant incentives / compensation
+   e. Printing, copying, publication charges
+
+5. OTHER DIRECT COSTS
+   a. Subcontracts / subawards
+   b. Consultant fees
+   c. Human subjects costs (IRB fees, participant payments)
+   d. Publication fees (open access charges)
+   e. Specialized services (sequencing, imaging, surveys)
+
+6. INDIRECT COSTS (F&A - Facilities and Administration)
+   a. Calculated as percentage of modified total direct costs
+   b. Rate negotiated between institution and government
+   c. Typical US university rate: 50-65% (on-campus)
+   d. Some agencies cap indirect costs
+```
+
+## Cost Estimation
+
+### Personnel Cost Calculation
+
+```
+Estimating personnel costs:
+
+PI salary:
+  Monthly salary = Annual salary / 12
+  Person-months requested = Calendar months of effort
+  Cost = Monthly salary x Person-months
+  Benefits = Cost x Fringe benefit rate
+
+  Example:
+    Annual salary: $120,000
+    Effort: 2 summer months (of 12 calendar months)
+    Salary cost: $120,000 / 12 x 2 = $20,000
+    Fringe benefits at 30%: $6,000
+    Total PI cost: $26,000 per year
+
+Postdoc salary:
+  Check institution's postdoc salary scale
+  NIH NRSA stipend levels provide a common benchmark
+  Include annual raises (3-4% per year)
+  Include full benefits (health insurance, retirement)
+
+  Example (3-year project):
+    Year 1: $56,000 + 30% fringe = $72,800
+    Year 2: $57,680 + 30% fringe = $74,984
+    Year 3: $59,410 + 30% fringe = $77,233
+    Total: $225,017
+
+Graduate student:
+  Stipend (12 months): varies by institution ($25,000-$40,000)
+  Tuition remission: often charged to the grant ($15,000-$50,000)
+  Health insurance: $2,000-$5,000/year
+  Total per student per year: $42,000-$95,000
+```
+
+### Inflation and Multi-Year Projections
+
+```python
+def project_costs(base_cost, years, inflation_rate=0.03):
+    """
+    Project costs over multiple years with inflation.
+
+    Most agencies expect 3% annual inflation for personnel
+    and 2-5% for supplies depending on the field.
+    """
+    yearly_costs = []
+    for year in range(years):
+        adjusted = base_cost * (1 + inflation_rate) ** year
+        yearly_costs.append(round(adjusted, 2))
+    return yearly_costs
+
+# Example: $50,000 postdoc base over 4 years
+# project_costs(50000, 4, 0.03)
+# Returns: [50000.00, 51500.00, 53045.00, 54636.35]
+```
+
+## Budget Justification Writing
+
+### Structure and Tone
+
+The budget justification is a narrative document that explains WHY each cost is necessary. It should demonstrate that every dollar serves the scientific goals.
+
+```
+Budget Justification Template:
+
+A. Personnel
+
+Principal Investigator (Dr. Jane Smith): 2 calendar months of
+effort per year ($20,000 salary + $6,000 fringe = $26,000/year).
+Dr. Smith will oversee all aspects of the project, including
+experimental design, data analysis, and manuscript preparation.
+Her expertise in computational neuroscience (see Biographical
+Sketch) is essential for the proposed machine learning analyses.
+
+Postdoctoral Researcher (TBD): 12 calendar months of effort per
+year ($56,000 salary + $16,800 fringe = $72,800 Year 1, with 3%
+annual increases). The postdoc will conduct the primary
+computational analyses, develop the novel algorithms described in
+Aim 2, and train graduate students on the methodology.
+
+B. Equipment
+
+GPU Computing Server ($35,000): A dedicated server with 4 NVIDIA
+A100 GPUs is required for training the deep learning models
+described in Aim 2. Cloud computing was considered but would cost
+approximately $45,000 over the project period based on estimated
+compute hours, making a dedicated server more cost-effective.
+
+C. Travel
+
+Conference travel ($3,000/year): Funds for the PI or postdoc to
+attend one domestic conference (estimated: $1,800 for
+registration, airfare, hotel, and per diem) and one workshop
+($1,200). Target venues include NeurIPS and the Computational
+Neuroscience annual meeting, where we will present project
+results and recruit collaborators.
+
+D. Materials and Supplies
+
+Cloud computing ($5,000/year): AWS credits for preliminary
+analyses and data storage. Estimated 500 GPU-hours at $3/hour
+plus 10 TB storage at $0.023/GB/month.
+
+Software licenses ($2,000/year): MATLAB license ($500),
+specialized neuroimaging analysis package ($1,500).
+```
+
+## Agency-Specific Rules
+
+### Common Restrictions by Funder
+
+```
+NSF (National Science Foundation):
+  - PI salary: max 2 months from all NSF grants combined
+  - Equipment threshold: $5,000 per item
+  - No construction costs
+  - Indirect costs: full negotiated rate
+  - Mandatory cost-sharing: generally prohibited (with exceptions)
+
+NIH (National Institutes of Health):
+  - Salary cap: currently ~$221,900 (check annually)
+  - Modular budgets: up to $250K direct costs/year (R01)
+  - Detailed budgets: required above $250K/year
+  - Equipment threshold: $5,000
+  - Indirect costs: full negotiated rate
+
+ERC (European Research Council):
+  - 100% of eligible costs + 25% indirect flat rate
+  - No consortium required (single PI)
+  - Host institution must be in EU/associated country
+  - Personnel must be directly employed
+
+EPSRC (UK Engineering and Physical Sciences):
+  - Full economic costing (fEC) model
+  - EPSRC pays 80% of fEC
+  - Directly incurred, directly allocated, and indirect costs
+  - Estates and indirect rates set by institution
+```
+
+## Common Budget Mistakes
+
+### Red Flags That Concern Reviewers
+
+```
+Mistakes to avoid:
+
+1. Padding the budget:
+   Problem: Inflated costs "just in case"
+   Fix: Estimate realistically, use published cost data
+
+2. Insufficient personnel:
+   Problem: Ambitious aims but only 1 person for 5 years
+   Fix: Match staffing to the work plan realistically
+
+3. Missing cost categories:
+   Problem: No travel budget but claims dissemination plan
+   Fix: Budget must align with proposed activities
+
+4. Unjustified equipment:
+   Problem: Expensive equipment without explanation of need
+   Fix: Explain why existing institutional resources are inadequate
+
+5. No inflation adjustment:
+   Problem: Same salary Year 1 through Year 5
+   Fix: Include 3% annual increases for personnel
+
+6. Excessive foreign travel:
+   Problem: 4 international trips per year for one PI
+   Fix: 1-2 conferences per year is typical and defensible
+
+7. Large consultant fees without justification:
+   Problem: $50,000 for unnamed consultant
+   Fix: Name the consultant, explain unique expertise,
+        provide hourly rate and estimated hours
+
+8. Forgetting open access fees:
+   Problem: Many funders now mandate open access publication
+   Fix: Budget $2,000-$5,000 per paper for APC charges
+```
+
+## Handling Budget Cuts
+
+### Negotiation Strategies
+
+```
+When your budget is reduced by the agency:
+
+Strategy 1 - Reduce scope proportionally:
+  "With a 20% reduction, we will focus on Aims 1 and 2,
+   deferring Aim 3 to a subsequent proposal."
+
+Strategy 2 - Reduce personnel:
+  "We will hire 1 postdoc instead of 2, extending the
+   timeline for Aim 2 by 6 months."
+
+Strategy 3 - Find alternative resources:
+  "The PI's department has agreed to provide 1 month of
+   summer salary, reducing the budget request by $15,000."
+
+Strategy 4 - Adjust equipment plans:
+  "We will use institutional HPC resources instead of
+   purchasing dedicated hardware, saving $35,000 but
+   adding $8,000 in computing time charges."
+
+What NOT to do:
+  - Do not agree to do the same work with less money
+  - Do not cut travel to zero (undermines dissemination)
+  - Do not eliminate graduate student support (reviewers notice)
+  - Do not remove the budget justification details
+```
+
+A well-prepared budget demonstrates that the research team has thoughtfully planned the project, understands what resources are truly needed, and will be responsible stewards of public funds. Budget quality correlates with proposal quality in the minds of reviewers, and a sloppy budget can undermine an otherwise strong scientific narrative.

package/skills/research/funding/nih-reporter-api-guide/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: nih-reporter-api-guide
+description: "Search NIH-funded grants and research projects via RePORTER API"
+metadata:
+  openclaw:
+    emoji: "🧬"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["nih", "grants", "biomedical", "funding", "reporter", "health-research"]
+    source: "https://api.reporter.nih.gov/"
+---
+
+# NIH RePORTER API Guide
+
+## Overview
+
+NIH RePORTER (Research Portfolio Online Reporting Tools) provides a comprehensive API for searching and analyzing grants funded by the National Institutes of Health and other agencies within the U.S. Department of Health and Human Services. The database includes project details, funding amounts, publications, patents, and clinical studies linked to funded research.
+
+RePORTER is the authoritative source for NIH grant data and covers billions of dollars in annual biomedical research funding. The API enables programmatic access to search for funded projects, retrieve associated publications, and analyze funding trends across NIH institutes, study sections, and disease categories.
+
+The v2 API is a modern RESTful service that accepts JSON POST bodies for search requests and returns structured JSON responses. It is completely free and requires no authentication.
+
+## Authentication
+
+No authentication is required. The NIH RePORTER API is a free public service.
+
+```bash
+# No API key needed
+curl -X POST "https://api.reporter.nih.gov/v2/projects/search" \
+  -H "Content-Type: application/json" \
+  -d '{"criteria":{"advanced_text_search":{"search_field":"terms","search_text":"CRISPR"}},"limit":5}'
+```
+
+## Core Endpoints
+
+### Search Projects
+
+The primary endpoint for finding NIH-funded grants and projects.
+
+```
+POST https://api.reporter.nih.gov/v2/projects/search
+```
+
+**Request body (JSON):**
+- `criteria.advanced_text_search`: Text query with `search_field` and `search_text`
+- `criteria.fiscal_years`: Array of fiscal years (e.g., [2023, 2024, 2025])
+- `criteria.pi_names`: Array of PI name objects with `first_name`, `last_name`
+- `criteria.org_names`: Array of institution names
+- `criteria.agencies`: Array of agency codes (e.g., ["NIH"])
+- `criteria.activity_codes`: Grant mechanism codes (e.g., ["R01", "R21"])
+- `limit`: Results per page (max 500)
+- `offset`: Pagination offset
+
+**Example: Search for CRISPR gene editing R01 grants:**
+
+```bash
+curl -s -X POST "https://api.reporter.nih.gov/v2/projects/search" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "criteria": {
+      "advanced_text_search": {
+        "search_field": "projecttitle,terms",
+        "search_text": "CRISPR gene editing"
+      },
+      "activity_codes": ["R01"],
+      "fiscal_years": [2024, 2025]
+    },
+    "limit": 10,
+    "offset": 0
+  }' | python3 -m json.tool
+```
+
+### Search Publications
+
+Find publications linked to NIH-funded projects.
+
+```
+POST https://api.reporter.nih.gov/v2/publications/search
+```
+
+```bash
+curl -s -X POST "https://api.reporter.nih.gov/v2/publications/search" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "criteria": {
+      "core_project_nums": ["R01GM123456"]
+    },
+    "limit": 25,
+    "offset": 0
+  }' | python3 -m json.tool
+```
+
+### Python Example: Analyze NIH Funding by Institute
+
+```python
+import requests
+
+API_URL = "https://api.reporter.nih.gov/v2/projects/search"
+
+def search_nih_projects(query, fiscal_years=None, activity_codes=None, limit=50):
+    """Search NIH RePORTER for funded projects."""
+    payload = {
+        "criteria": {
+            "advanced_text_search": {
+                "search_field": "projecttitle,terms",
+                "search_text": query
+            }
+        },
+        "limit": limit,
+        "offset": 0
+    }
+    if fiscal_years:
+        payload["criteria"]["fiscal_years"] = fiscal_years
+    if activity_codes:
+        payload["criteria"]["activity_codes"] = activity_codes
+
+    resp = requests.post(API_URL, json=payload)
+    resp.raise_for_status()
+    data = resp.json()
+    return data.get("results", []), data.get("meta", {}).get("total", 0)
+
+results, total = search_nih_projects(
+    "Alzheimer disease biomarkers",
+    fiscal_years=[2024, 2025],
+    activity_codes=["R01", "R21", "U01"]
+)
+print(f"Total matching projects: {total}")
+
+institute_totals = {}
+for project in results:
+    ic = project.get("agency_ic_fundings", [])
+    for funding in ic:
+        name = funding.get("abbreviation", "Unknown")
+        amount = funding.get("total_cost", 0) or 0
+        institute_totals[name] = institute_totals.get(name, 0) + amount
+
+for inst, total_amt in sorted(institute_totals.items(), key=lambda x: -x[1]):
+    print(f"  {inst}: ${total_amt:,.0f}")
+```
+
+## Common Research Patterns
+
+**Grant Prospecting:** Search for recently funded projects in your area to understand current NIH priorities, typical award sizes by mechanism (R01, R21, K99, etc.), and successful project framing.
+
+**Publication-Grant Linkage:** Use the publications endpoint to find papers produced from specific grants, enabling analysis of research output and impact per dollar invested.
+
+**PI Network Analysis:** Search by PI name to map a researcher's full NIH funding history, co-investigators, and institutional affiliations over time.
+
+**Funding Trend Tracking:** Query across multiple fiscal years with consistent keywords to track how NIH investment evolves in emerging areas such as AI in healthcare, mRNA therapeutics, or long COVID.
+
+## Rate Limits and Best Practices
+
+- **No authentication required** but the API has reasonable use expectations
+- **Max results per request:** 500 (use `offset` for pagination)
+- **Recommended delay:** 0.5 seconds between paginated requests
+- **POST-only:** All search endpoints use POST with JSON bodies, not GET parameters
+- **Field selection:** Use `include_fields` in the request body to limit response fields for faster responses
+- **Fiscal year filtering:** Always include `fiscal_years` to narrow results and improve performance
+- **Error handling:** Check HTTP status codes; the API returns 400 for malformed requests with descriptive error messages
+
+## References
+
+- NIH RePORTER API v2 Documentation: https://api.reporter.nih.gov/
+- NIH RePORTER Web Interface: https://reporter.nih.gov/
+- NIH Activity Codes (Grant Mechanisms): https://grants.nih.gov/grants/funding/ac_search_results.htm
+- NIH Institutes and Centers: https://www.nih.gov/institutes-nih/list-nih-institutes-centers-offices

package/skills/research/funding/nsf-award-api-guide/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: nsf-award-api-guide
+description: "Search NSF awards and grants with free public API, no auth required"
+metadata:
+  openclaw:
+    emoji: "🏛️"
+    category: "research"
+    subcategory: "funding"
+    keywords: ["nsf", "grants", "funding", "awards", "national-science-foundation"]
+    source: "https://www.research.gov/common/webapi/awardapisearch-v1.htm"
+---
+
+# NSF Award Search API Guide
+
+## Overview
+
+The National Science Foundation (NSF) Award Search API provides free, unauthenticated access to a comprehensive database of NSF-funded awards spanning decades of federally funded research in the United States. This API is invaluable for researchers seeking to understand funding trends, identify potential collaborators, or find precedent awards in their field.
+
+The API covers all NSF directorates including Computer and Information Science and Engineering (CISE), Biological Sciences (BIO), Engineering (ENG), Geosciences (GEO), Mathematical and Physical Sciences (MPS), Social, Behavioral and Economic Sciences (SBE), and Education and Human Resources (EHR). Each award record includes principal investigator information, award amounts, abstracts, and institutional details.
+
+No API key or authentication is needed. The service returns JSON or XML and supports a wide range of query parameters for precise filtering.
+
+## Authentication
+
+No authentication is required. The NSF Award Search API is completely open and free to use.
+
+```bash
+# No API key needed -- just make the request
+curl "https://api.nsf.gov/services/v1/awards.json?keyword=quantum+computing"
+```
+
+## Core Endpoints
+
+### Search Awards
+
+```
+GET https://api.nsf.gov/services/v1/awards.json?{params}
+```
+
+**Key Parameters:**
+- `keyword`: Full-text search across award title and abstract
+- `piFirstName`, `piLastName`: Filter by principal investigator name
+- `awardeeCity`, `awardeeStateCode`: Filter by institution location
+- `startDateStart`, `startDateEnd`: Date range (format: MM/DD/YYYY)
+- `fundProgramName`: NSF program name
+- `awardeeName`: Institution name
+- `offset`: Pagination offset (default 1)
+- `printFields`: Comma-separated list of fields to return
+
+**Example: Search for machine learning awards at MIT:**
+
+```bash
+curl -s "https://api.nsf.gov/services/v1/awards.json?\
+keyword=machine+learning&\
+awardeeName=Massachusetts+Institute+of+Technology&\
+printFields=id,title,piFirstName,piLastName,startDate,awardeeName,fundsObligatedAmt,abstractText&\
+offset=1" | python3 -m json.tool
+```
+
+### Get Award by ID
+
+Retrieve details for a specific award by its NSF award number.
+
+```bash
+curl -s "https://api.nsf.gov/services/v1/awards/2345678.json?\
+printFields=id,title,piFirstName,piLastName,startDate,expDate,awardeeName,fundsObligatedAmt,abstractText" \
+  | python3 -m json.tool
+```
+
+### Python Example: Funding Trend Analysis
+
+```python
+import requests
+import time
+
+base_url = "https://api.nsf.gov/services/v1/awards.json"
+
+def search_nsf_awards(keyword, year_start, year_end, max_results=100):
+    """Search NSF awards and return structured results."""
+    results = []
+    offset = 1
+
+    while len(results) < max_results:
+        params = {
+            "keyword": keyword,
+            "startDateStart": f"01/01/{year_start}",
+            "startDateEnd": f"12/31/{year_end}",
+            "printFields": "id,title,piFirstName,piLastName,startDate,awardeeName,fundsObligatedAmt",
+            "offset": offset
+        }
+        resp = requests.get(base_url, params=params)
+        data = resp.json()
+        awards = data.get("response", {}).get("award", [])
+        if not awards:
+            break
+        results.extend(awards)
+        offset += 25
+        time.sleep(0.5)
+
+    return results[:max_results]
+
+awards = search_nsf_awards("large language models", 2022, 2025)
+total_funding = sum(int(a.get("fundsObligatedAmt", 0)) for a in awards)
+print(f"Found {len(awards)} awards, total funding: ${total_funding:,}")
+
+for a in awards[:5]:
+    print(f"  [{a['id']}] {a['title']} — ${int(a.get('fundsObligatedAmt', 0)):,}")
+```
+
+## Common Research Patterns
+
+**Grant Prospecting:** Search for awards in your field to understand typical funding amounts, common program solicitations, and successful framing of research projects. Analyze abstracts of funded proposals for vocabulary and scope.
+
+**Collaborator Discovery:** Search by keyword and explore the PI network to identify active researchers and institutions. Cross-reference with publication databases to find potential collaborators.
+
+**Funding Landscape Analysis:** Track funding volumes over time for specific keywords or programs to identify emerging priorities and declining areas. Useful for strategic planning and grant writing.
+
+**Institutional Benchmarking:** Compare award counts and funding totals across institutions for a given field or directorate.
+
+## Rate Limits and Best Practices
+
+- **No formal rate limit** is published, but be respectful; add 0.5-1 second delays between paginated requests
+- **Default page size:** 25 awards per request (use `offset` to paginate)
+- **printFields:** Always specify `printFields` to reduce response size and improve performance
+- **Date formats:** Use MM/DD/YYYY format strictly
+- **Pagination:** The API uses 1-based offset; increment by 25 for each page
+- **Large datasets:** For bulk analysis, consider using the NSF data download at https://www.nsf.gov/awardsearch/download.jsp
+
+## References
+
+- NSF Award Search API Documentation: https://www.research.gov/common/webapi/awardapisearch-v1.htm
+- NSF Award Search Web Interface: https://www.nsf.gov/awardsearch/
+- NSF Data Downloads: https://www.nsf.gov/awardsearch/download.jsp