@wentorai/research-plugins 1.3.2 → 1.4.0

package/skills/domains/biomedical/medical-data-api/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: medical-data-api
+description: "Access FDA drug data and WHO global health statistics for research"
+metadata:
+  openclaw:
+    emoji: "💊"
+    category: "domains"
+    subcategory: "biomedical"
+    keywords: ["FDA", "drug safety", "WHO", "global health", "adverse events", "medical data", "pharmacovigilance"]
+    source: "https://open.fda.gov"
+---
+
+# Medical Data API Guide (openFDA + WHO GHO)
+
+## Overview
+
+This skill covers two major open medical data APIs for academic research:
+
+**openFDA** is the U.S. Food and Drug Administration's public API providing access to drug labeling (SPL), adverse event reports (FAERS), recalls, and NDC directory. The FAERS dataset contains over 722,000 reports for common drugs like aspirin, making it a primary pharmacovigilance resource.
+
+**WHO Global Health Observatory (GHO)** is the WHO's OData v4 API serving over 2,000 health indicators across 194 member states -- life expectancy, mortality, disease burden, health system coverage, risk factors, and SDG targets. Returns structured JSON with numeric values, confidence intervals, and dimensional breakdowns by country, sex, and year.
+
+Both APIs are free, require no authentication, and return JSON.
+
+## Authentication
+
+**openFDA**: No authentication required. An optional API key (free, via https://open.fda.gov/apis/authentication/) increases rate limits from 240/min to 120,000/day. Register at https://open.fda.gov/apis/ to obtain a key, then append `&api_key=YOUR_KEY` to requests.
+
+**WHO GHO**: No authentication required. No API key needed. All endpoints are publicly accessible with no registration.
+
+## Core Endpoints
+
+### openFDA: Drug Labels
+
+Search FDA-approved drug labeling data (Structured Product Labeling). Returns boxed warnings, indications, dosage, contraindications, and adverse reactions text.
+
+- **URL**: `GET https://api.fda.gov/drug/label.json`
+- **Parameters**:
+
+| Parameter | Type   | Required | Description                                         |
+|-----------|--------|----------|-----------------------------------------------------|
+| search    | string | No       | Search query using openFDA query syntax              |
+| limit     | int    | No       | Number of results (default 1, max 1000)              |
+| skip      | int    | No       | Offset for pagination                                |
+| count     | string | No       | Count unique values of a field                       |
+
+- **Example**:
+
+```bash
+curl "https://api.fda.gov/drug/label.json?search=aspirin&limit=1"
+```
+
+- **Response**: Returns `meta.results.total` (26,564 for "aspirin") and `results` array. Each result contains `boxed_warning`, `indications_and_usage`, `dosage_and_administration`, `warnings`, `adverse_reactions`, `drug_interactions`, and `openfda` cross-references (brand/generic names, manufacturer, NDC, pharmacologic class).
+
+### openFDA: Adverse Events (FAERS)
+
+Search the FDA Adverse Event Reporting System. Each record describes a safety report including patient demographics, suspect drugs, reported reactions, and outcomes.
+
+- **URL**: `GET https://api.fda.gov/drug/event.json`
+- **Parameters**:
+
+| Parameter | Type   | Required | Description                                         |
+|-----------|--------|----------|-----------------------------------------------------|
+| search    | string | No       | Query (e.g., `patient.drug.openfda.brand_name:"aspirin"`) |
+| limit     | int    | No       | Number of results (default 1, max 1000)              |
+| skip      | int    | No       | Offset for pagination (max skip+limit = 26,000)      |
+| count     | string | No       | Count field values (e.g., `patient.reaction.reactionmeddrapt.exact`) |
+
+- **Example**:
+
+```bash
+curl 'https://api.fda.gov/drug/event.json?search=patient.drug.openfda.brand_name:"aspirin"&limit=1'
+```
+
+- **Response**: Returns `meta.results.total` (722,607 for aspirin). Each result: `safetyreportid`, `serious` (1=yes, 2=no), `primarysourcecountry`, `receivedate`, nested `patient` with `patientsex`, `reaction` array (MedDRA terms + `reactionoutcome`), and `drug` array with `drugcharacterization` (1=suspect, 2=concomitant, 3=interacting), `medicinalproduct`, `openfda` cross-references.
+
+### WHO GHO: Health Indicator Data
+
+Retrieve data points for a specific health indicator with country, year, and sex dimensions.
+
+- **URL**: `GET https://ghoapi.azureedge.net/api/{IndicatorCode}`
+- **Parameters** (OData v4 query options):
+
+| Parameter | Type   | Required | Description                                           |
+|-----------|--------|----------|-------------------------------------------------------|
+| $top      | int    | No       | Limit number of records returned                       |
+| $skip     | int    | No       | Skip records for pagination                            |
+| $filter   | string | No       | OData filter (e.g., `SpatialDim eq 'USA' and TimeDim eq 2020`) |
+| $select   | string | No       | Select specific fields                                 |
+| $orderby  | string | No       | Sort results                                           |
+
+- **Example**:
+
+```bash
+# Life expectancy at birth (WHOSIS_000001)
+curl "https://ghoapi.azureedge.net/api/WHOSIS_000001?\$top=2"
+```
+
+- **Response**: OData JSON with `value` array. Each record: `SpatialDim` (ISO country, e.g., "BTN"), `ParentLocation` (WHO region), `TimeDim` (year), `Dim1` (sex: "SEX_BTSX"/"SEX_MLE"/"SEX_FMLE"), `Value` ("67.8 [67.1-68.6]"), `NumericValue` (67.845665), `Low`/`High` confidence bounds.
+
+### WHO GHO: Indicator Directory
+
+List available health indicators with their codes and names.
+
+- **URL**: `GET https://ghoapi.azureedge.net/api/Indicator`
+- **Example**:
+
+```bash
+curl "https://ghoapi.azureedge.net/api/Indicator?\$top=5"
+```
+
+- **Response**: Array of entries with `IndicatorCode` (e.g., "Adult_curr_e-cig"), `IndicatorName` (e.g., "Prevalence of current e-cigarette use among adults (%)"), `Language` ("EN"). Over 2,000 indicators spanning mortality, morbidity, health systems, and risk factors.
+
+## Rate Limits
+
+**openFDA**:
+- Without API key: 240 requests per minute (burst), 1,000 requests per day
+- With free API key: 240 requests per minute, 120,000 requests per day
+- Pagination ceiling: `skip` + `limit` cannot exceed 26,000 (use `search` + `sort` for deeper access)
+
+**WHO GHO**:
+- No documented rate limits; the service runs on Azure CDN (azureedge.net)
+- Recommended: keep requests under 10/second for courtesy
+- For bulk downloads, use the GHO data portal CSV exports at https://www.who.int/data/gho
+
+## Academic Use Cases
+
+### Pharmacovigilance: Adverse Event Signal Detection
+
+Count reactions by MedDRA term to identify safety signals:
+
+```python
+import requests
+
+resp = requests.get("https://api.fda.gov/drug/event.json", params={
+    "search": 'patient.drug.openfda.brand_name:"aspirin"',
+    "count": "patient.reaction.reactionmeddrapt.exact",
+    "limit": 10
+})
+for r in resp.json()["results"]:
+    print(f"  {r['term']}: {r['count']} reports")
+```
+
+### Epidemiology: Cross-National Health Comparisons
+
+Compare health indicators across countries and time periods:
+
+```python
+import requests
+
+resp = requests.get("https://ghoapi.azureedge.net/api/WHOSIS_000001", params={
+    "$filter": "SpatialDim eq 'JPN' and Dim1 eq 'SEX_BTSX'",
+    "$orderby": "TimeDim desc",
+    "$top": 10
+})
+for row in resp.json()["value"]:
+    print(f"  Japan {row['TimeDim']}: {row['Value']}")
+```
+
+### Public Health: Drug Label Comparison
+
+Compare safety language across drug labels for regulatory research:
+
+```python
+import requests
+
+for drug in ["ibuprofen", "naproxen", "celecoxib"]:
+    resp = requests.get("https://api.fda.gov/drug/label.json",
+        params={"search": f'openfda.generic_name:"{drug}"', "limit": 1})
+    results = resp.json().get("results", [])
+    if results:
+        warning = results[0].get("boxed_warning", ["None"])[0][:200]
+        print(f"{drug.upper()}: {warning}...\n")
+```
+
+## Key Indicator Codes (WHO GHO)
+
+| Code | Indicator |
+|------|-----------|
+| WHOSIS_000001 | Life expectancy at birth |
+| NCDMORT3070 | NCD mortality (30-70 years) |
+| MDG_0000000001 | Under-five mortality rate |
+| WHS4_100 | Physicians per 10,000 population |
+| NCD_BMI_30A | Prevalence of obesity (BMI >= 30) |
+| SA_0000001688 | Alcohol per capita consumption |
+| TOBACCO_0000000262 | Tobacco smoking prevalence |
+
+## References
+
+- openFDA documentation: https://open.fda.gov/apis/
+- openFDA API key registration: https://open.fda.gov/apis/authentication/
+- openFDA query syntax: https://open.fda.gov/apis/query-syntax/
+- openFDA GitHub: https://github.com/FDA/openfda
+- WHO GHO API documentation: https://www.who.int/data/gho/info/gho-odata-api
+- WHO GHO OData endpoint: https://ghoapi.azureedge.net/api/
+- WHO GHO indicator list: https://ghoapi.azureedge.net/api/Indicator
+- WHO Global Health Observatory portal: https://www.who.int/data/gho

package/skills/domains/biomedical/pdb-structure-api/SKILL.md

@@ -0,0 +1,219 @@
+---
+name: pdb-structure-api
+description: "Search and retrieve 3D protein structures from the RCSB Protein Data Bank"
+metadata:
+  openclaw:
+    emoji: "🔮"
+    category: "domains"
+    subcategory: "biomedical"
+    keywords: ["protein structure", "PDB", "crystallography", "structural biology", "RCSB", "molecular structure"]
+    source: "https://data.rcsb.org"
+---
+
+# RCSB Protein Data Bank API Guide
+
+## Overview
+
+The RCSB Protein Data Bank (PDB) is the single global archive for experimentally determined 3D structures of biological macromolecules. It hosts over 200,000 structures resolved by X-ray crystallography, cryo-EM, NMR spectroscopy, and other methods. Each entry includes atomic coordinates, experimental metadata, polymer sequences, bound ligands, and literature references.
+
+Two complementary APIs are available. The **Data API** (`data.rcsb.org`) serves structured entry metadata, polymer entities, and chemical components via RESTful GET endpoints. The **Search API** (`search.rcsb.org`) supports full-text, attribute-based, sequence similarity, and structure similarity searches.
+
+## Authentication
+
+No authentication required. Both APIs are freely accessible without API keys, tokens, or registration.
+
+## Core Endpoints
+
+### Data API: Get Entry by PDB ID
+
+Retrieve metadata for a structure including experimental method, resolution, citations, and bound components.
+
+- **URL**: `GET https://data.rcsb.org/rest/v1/core/entry/{pdb_id}`
+
+```bash
+curl "https://data.rcsb.org/rest/v1/core/entry/4HHB"
+```
+
+- **Response** (key fields):
+
+```json
+{
+  "rcsb_id": "4HHB",
+  "struct": {
+    "title": "THE CRYSTAL STRUCTURE OF HUMAN DEOXYHAEMOGLOBIN AT 1.74 ANGSTROMS RESOLUTION"
+  },
+  "exptl": [{"method": "X-RAY DIFFRACTION"}],
+  "rcsb_entry_info": {
+    "deposited_atom_count": 4779,
+    "molecular_weight": 64.74,
+    "polymer_composition": "heteromeric protein",
+    "polymer_entity_count_protein": 2,
+    "resolution_combined": [1.74],
+    "nonpolymer_bound_components": ["HEM"]
+  }
+}
+```
+
+### Data API: Get Polymer Entity
+
+Retrieve protein/nucleic acid entity details including sequence, organism, and gene info.
+
+- **URL**: `GET https://data.rcsb.org/rest/v1/core/polymer_entity/{pdb_id}/{entity_id}`
+
+```bash
+curl "https://data.rcsb.org/rest/v1/core/polymer_entity/4HHB/1"
+```
+
+- **Response** (key fields):
+
+```json
+{
+  "entity_poly": {
+    "pdbx_seq_one_letter_code_can": "VLSPADKTNVKAAWGKVGAHAGEYGAEALERMFLSFPTTKTYFPHFDLSH...",
+    "rcsb_entity_polymer_type": "Protein",
+    "rcsb_sample_sequence_length": 141,
+    "type": "polypeptide(L)"
+  },
+  "entity_src_gen": [{
+    "gene_src_common_name": "Human",
+    "pdbx_gene_src_scientific_name": "Homo sapiens",
+    "pdbx_gene_src_ncbi_taxonomy_id": "9606"
+  }]
+}
+```
+
+### Data API: Get Chemical Component
+
+Retrieve ligand or small molecule metadata by component ID.
+
+- **URL**: `GET https://data.rcsb.org/rest/v1/core/chemcomp/{comp_id}`
+
+```bash
+curl "https://data.rcsb.org/rest/v1/core/chemcomp/HEM"
+```
+
+- **Response** (key fields):
+
+```json
+{
+  "rcsb_id": "HEM",
+  "chem_comp": {
+    "formula": "C34 H32 Fe N4 O4",
+    "formula_weight": 616.487,
+    "name": "PROTOPORPHYRIN IX CONTAINING FE",
+    "type": "non-polymer"
+  }
+}
+```
+
+### Search API: Full-Text Search
+
+Search across all PDB entries with free-text queries. Returns ranked results by relevance.
+
+- **URL**: `POST https://search.rcsb.org/rcsbsearch/v2/query`
+- **Headers**: `Content-Type: application/json`
+- **Key body fields**: `query.type` (`"terminal"`), `query.service` (`"full_text"`, `"text"`, `"sequence"`, `"structure"`), `query.parameters.value`, `return_type` (`"entry"`, `"polymer_entity"`, `"assembly"`), `request_options.paginate.start/rows`
+
+```bash
+curl -X POST "https://search.rcsb.org/rcsbsearch/v2/query" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": {
+      "type": "terminal",
+      "service": "full_text",
+      "parameters": {"value": "hemoglobin"}
+    },
+    "return_type": "entry",
+    "request_options": {
+      "results_content_type": ["experimental"],
+      "paginate": {"start": 0, "rows": 3}
+    }
+  }'
+```
+
+- **Response**:
+
+```json
+{
+  "query_id": "6f7192a6-d65b-4ff1-9d94-37b9600a8864",
+  "result_type": "entry",
+  "total_count": 8960,
+  "result_set": [
+    {"identifier": "3GOU", "score": 1.0},
+    {"identifier": "6IHX", "score": 0.9995},
+    {"identifier": "2PGH", "score": 0.9985}
+  ]
+}
+```
+
+For attribute-based searches, use `"service": "text"` with `"attribute"` and `"operator"` fields. Combine multiple criteria with `"type": "group"` and `"logical_operator": "and"`.
+
+## Rate Limits
+
+No formal rate limits or rate-limit headers are published. RCSB recommends reasonable request rates. For bulk data, use FTP downloads at `https://files.rcsb.org/pub/pdb/` or `ftp://ftp.wwpdb.org/pub/pdb/` instead of iterative API calls.
+
+## Academic Use Cases
+
+- **Structure-Based Drug Design**: Retrieve target protein structures with bound ligands to analyze binding pockets, then search for similar structures to identify drug scaffolds.
+- **Comparative Structural Analysis**: Search all structures of a protein family, compare resolution and methods, select the best template for homology modeling.
+- **Protein Engineering**: Retrieve wild-type structures and cross-reference with mutant entries to analyze how mutations affect fold stability and ligand interactions.
+
+## Code Examples
+
+### Search and Retrieve Structures
+
+```python
+import requests
+
+# Search for kinase inhibitor structures
+search_body = {
+    "query": {"type": "terminal", "service": "full_text",
+              "parameters": {"value": "tyrosine kinase inhibitor"}},
+    "return_type": "entry",
+    "request_options": {"results_content_type": ["experimental"],
+                        "paginate": {"start": 0, "rows": 5}}
+}
+results = requests.post("https://search.rcsb.org/rcsbsearch/v2/query",
+                        json=search_body).json()
+print(f"Total hits: {results['total_count']}")
+
+# Retrieve metadata for each hit
+for hit in results["result_set"]:
+    pdb_id = hit["identifier"]
+    entry = requests.get(
+        f"https://data.rcsb.org/rest/v1/core/entry/{pdb_id}").json()
+    info = entry["rcsb_entry_info"]
+    print(f"{pdb_id}: {entry['struct']['title'][:80]}")
+    print(f"  Resolution: {info.get('resolution_combined', ['N/A'])[0]} A, "
+          f"Method: {info['experimental_method']}")
+```
+
+### Extract Polymer Sequences
+
+```python
+import requests
+
+pdb_id = "4HHB"
+entry = requests.get(
+    f"https://data.rcsb.org/rest/v1/core/entry/{pdb_id}").json()
+
+for eid in range(1, entry["rcsb_entry_info"]["polymer_entity_count"] + 1):
+    entity = requests.get(
+        f"https://data.rcsb.org/rest/v1/core/polymer_entity/{pdb_id}/{eid}"
+    ).json()
+    poly = entity["entity_poly"]
+    src = entity.get("rcsb_entity_source_organism", [{}])[0]
+    print(f"Entity {eid}: {poly['rcsb_entity_polymer_type']} "
+          f"({src.get('ncbi_scientific_name', 'N/A')})")
+    print(f"  {poly['rcsb_sample_sequence_length']} residues: "
+          f"{poly['pdbx_seq_one_letter_code_can'][:50]}...")
+```
+
+## References
+
+- Data API docs: https://data.rcsb.org/redoc/index.html
+- Search API docs: https://search.rcsb.org/index.html
+- RCSB PDB homepage: https://www.rcsb.org/
+- Programmatic access guide: https://www.rcsb.org/docs/programmatic-access
+- PDB file format: https://www.wwpdb.org/documentation/file-format
+- Worldwide PDB: https://www.wwpdb.org/

package/skills/domains/business/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: business-skills
-description: "6 business research skills. Trigger: business strategy, market analysis, competitive intelligence. Design: analytical frameworks and methods for management and innovation research."
+description: "5 business research skills. Trigger: business strategy, market analysis, competitive intelligence. Design: analytical frameworks and methods for management and innovation research."
 ---
 
-# Business Research — 6 Skills
+# Business Research — 5 Skills
 
 Select the skill matching the user's need, then `read` its SKILL.md.
 
@@ -14,4 +14,3 @@ Select the skill matching the user's need, then `read` its SKILL.md.
 | [market-analysis-guide](./market-analysis-guide/SKILL.md) | Structured frameworks for market sizing, competitive analysis, and strategic ... |
 | [operations-research-guide](./operations-research-guide/SKILL.md) | Optimization and operations research methods for business and logistics |
 | [strategic-management-guide](./strategic-management-guide/SKILL.md) | Frameworks for strategic planning, resource allocation, and organizational an... |
-| [xpert-bi-guide](./xpert-bi-guide/SKILL.md) | AI business intelligence agent with NL-to-SQL and dashboards |

package/skills/domains/chemistry/SKILL.md

@@ -1,15 +1,16 @@
 ---
 name: chemistry-skills
-description: "8 chemistry skills. Trigger: chemical structure analysis, reaction prediction, molecular modeling. Design: computational chemistry tools and cheminformatics workflows."
+description: "9 chemistry skills. Trigger: chemical structure analysis, reaction prediction, molecular modeling. Design: computational chemistry tools and cheminformatics workflows."
 ---
 
-# Chemistry — 8 Skills
+# Chemistry — 9 Skills
 
 Select the skill matching the user's need, then `read` its SKILL.md.
 
 | Skill | Description |
 |-------|-------------|
 | [cactus-cheminformatics-guide](./cactus-cheminformatics-guide/SKILL.md) | PNNL cheminformatics LLM agent for molecular analysis |
+| [catalysis-hub-api](./catalysis-hub-api/SKILL.md) | Query computational catalysis reaction data via Catalysis Hub GraphQL |
 | [chemeagle-guide](./chemeagle-guide/SKILL.md) | Multi-agent system for chemical literature information extraction |
 | [chemgraph-agent-guide](./chemgraph-agent-guide/SKILL.md) | Automate molecular simulations with the ChemGraph agentic framework |
 | [computational-chemistry-guide](./computational-chemistry-guide/SKILL.md) | DFT, molecular simulation, and reaction prediction tools for chemists |

package/skills/domains/chemistry/catalysis-hub-api/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: catalysis-hub-api
+description: "Query computational catalysis reaction data via Catalysis Hub GraphQL"
+metadata:
+  openclaw:
+    emoji: "⚗️"
+    category: "domains"
+    subcategory: "chemistry"
+    keywords: ["catalysis", "DFT", "reaction energy", "surface chemistry", "computational chemistry", "GraphQL"]
+    source: "https://www.catalysis-hub.org"
+---
+
+# Catalysis Hub GraphQL API Guide
+
+## Overview
+
+Catalysis Hub is an open-access database of DFT-calculated reaction energies and activation barriers for heterogeneous catalysis, developed at SUNCAT Center (Stanford/SLAC). It aggregates computational results from published studies, enabling researchers to search, compare, and reuse DFT data for catalyst screening and mechanism validation.
+
+The GraphQL endpoint provides structured access to reactions, publications, and atomic structures. All data is linked to peer-reviewed publications and includes computational details (DFT code, XC functional, surface facet, coverage).
+
+## Authentication
+
+No authentication required. Catalysis Hub is a free public service with no API keys.
+
+## GraphQL Schema
+
+**Endpoint:** `https://api.catalysis-hub.org/graphql`
+
+All queries use HTTP POST with a JSON `query` field. Responses follow the Relay connection pattern (`edges`/`node`).
+
+### Root Query Types
+
+| Query | Description |
+|-------|-------------|
+| `reactions` | DFT-computed reaction energies and barriers |
+| `publications` | Published studies linked to reaction data |
+| `systems` | Atomic structure data (ASE Atoms objects) |
+| `species` | Chemical species involved in reactions |
+
+### Reaction Fields
+
+`chemicalComposition`, `surfaceComposition`, `facet`, `reactionEnergy` (eV), `activationEnergy` (eV), `dftCode` (e.g. `Quantum-Espresso`, `VASP-5.4.4`), `dftFunctional` (e.g. `RPBE`), `reactants` (JSON), `products` (JSON), `Equation` (e.g. `0.5O2(g) + * -> O*`)
+
+### Publication Fields
+
+`title`, `authors` (JSON), `journal`, `year` (Int), `doi`, `reactions` (linked Reaction list)
+
+## Core Queries
+
+### List Reactions
+
+```bash
+curl -s -X POST "https://api.catalysis-hub.org/graphql" \
+  -H "Content-Type: application/json" -d '{"query":"{ reactions(first: 3) { edges { node { chemicalComposition reactionEnergy activationEnergy surfaceComposition } } } }"}'
+```
+
+Response (truncated):
+
+```json
+{"data":{"reactions":{"edges":[
+  {"node":{"chemicalComposition":"Nb9Sn3","reactionEnergy":-9.687,"activationEnergy":null,"surfaceComposition":"Nb3Sn"}},
+  {"node":{"chemicalComposition":"Ir3V9","reactionEnergy":-8.395,"activationEnergy":null,"surfaceComposition":"V3Ir"}},
+  {"node":{"chemicalComposition":"Ir9Ni3","reactionEnergy":-2.005,"activationEnergy":null,"surfaceComposition":"Ir3Ni"}}
+]}}}
+```
+
+### Filter by Surface Composition
+
+```bash
+curl -s -X POST "https://api.catalysis-hub.org/graphql" \
+  -H "Content-Type: application/json" -d '{"query":"{ reactions(first: 2, surfaceComposition: \"Pt\") { edges { node { chemicalComposition surfaceComposition facet reactionEnergy dftCode dftFunctional Equation } } } }"}'
+```
+
+Response (truncated):
+
+```json
+{"data":{"reactions":{"edges":[
+  {"node":{"chemicalComposition":"Pt28","surfaceComposition":"Pt","facet":"100","reactionEnergy":0.856,"dftCode":"Quantum-Espresso","dftFunctional":"RPBE","Equation":"0.5N2(g) + * -> N*"}},
+  {"node":{"chemicalComposition":"Pt28","surfaceComposition":"Pt","facet":"100","reactionEnergy":-0.984,"dftCode":"Quantum-Espresso","dftFunctional":"RPBE","Equation":"0.5O2(g) + * -> O*"}}
+]}}}
+```
+
+### Search by Chemical Composition (partial match with `~` prefix)
+
+```bash
+curl -s -X POST "https://api.catalysis-hub.org/graphql" \
+  -H "Content-Type: application/json" -d '{"query":"{ reactions(first: 3, chemicalComposition: \"~CO\") { edges { node { chemicalComposition reactionEnergy dftCode } } } }"}'
+```
+
+Response (truncated):
+
+```json
+{"data":{"reactions":{"edges":[
+  {"node":{"chemicalComposition":"Co9Cr2FeMnNiO20","reactionEnergy":1.910,"dftCode":"VASP-5.4.4"}},
+  {"node":{"chemicalComposition":"Co9Cr2FeMnNiO20","reactionEnergy":0.648,"dftCode":"VASP-5.4.4"}},
+  {"node":{"chemicalComposition":"Co10CrFeMnNiO20","reactionEnergy":3.167,"dftCode":"VASP-5.4.4"}}
+]}}}
+```
+
+### Query Publications
+
+```bash
+curl -s -X POST "https://api.catalysis-hub.org/graphql" \
+  -H "Content-Type: application/json" -d '{"query":"{ publications(first: 2, year: 2019) { edges { node { title authors journal year doi } } } }"}'
+```
+
+Response (truncated):
+
+```json
+{"data":{"publications":{"edges":[
+  {"node":{"title":"High-Throughput Calculations of Catalytic Properties of Bimetallic Alloy Surfaces","authors":"[\"Mamun, Osman\",\"Winther, Kirsten T.\",\"Boes, Jacob R.\",\"Bligaard, Thomas\"]","journal":"Scientific Data","year":2019,"doi":"10.1038/s41597-019-0080-z"}},
+  {"node":{"title":"Selective high-temperature CO2 electrolysis enabled by oxidized carbon intermediates","journal":"Nature Energy","year":2019,"doi":"10.1038/s41560-019-0457-4"}}
+]}}}
+```
+
+## Rate Limits
+
+- No documented rate limits; add 200-500ms delays between requests as courtesy
+- Use `first` to limit results; pagination via cursor-based `after` argument
+
+## Academic Use Cases
+
+- **Catalyst Screening:** Compare adsorption energies across bimetallic alloy surfaces to identify candidates for target reactions (ORR, NRR, HER)
+- **DFT Validation:** Cross-reference your DFT results against published values matched by surface, facet, and functional
+- **Scaling Relations:** Retrieve adsorption energies across surfaces to build Bronsted-Evans-Polanyi (BEP) relations
+- **Literature Discovery:** Find publications by year or linked reactions for citation and methodology verification
+
+## Python Example
+
+```python
+import requests
+
+ENDPOINT = "https://api.catalysis-hub.org/graphql"
+
+def query_catalysis_hub(query):
+    """Execute a GraphQL query against Catalysis Hub."""
+    resp = requests.post(ENDPOINT, json={"query": query})
+    resp.raise_for_status()
+    return resp.json()["data"]
+
+# Screen adsorption energies on Pt surfaces
+data = query_catalysis_hub("""
+{
+  reactions(first: 20, surfaceComposition: "Pt") {
+    edges { node { Equation facet reactionEnergy dftFunctional } }
+  }
+}
+""")
+for edge in data["reactions"]["edges"]:
+    r = edge["node"]
+    print(f"{r['Equation']:<30} facet={r['facet']}  E={r['reactionEnergy']:+.3f} eV")
+
+# Publications with linked reactions
+pubs = query_catalysis_hub("""
+{
+  publications(first: 5, year: 2019) {
+    edges { node { title doi reactions { surfaceComposition Equation } } }
+  }
+}
+""")
+for edge in pubs["publications"]["edges"]:
+    pub = edge["node"]
+    print(f"{pub['title']} | DOI: {pub['doi']} | {len(pub.get('reactions') or [])} reactions")
+```
+
+## References
+
+- Catalysis Hub: https://www.catalysis-hub.org
+- GraphQL Endpoint: https://api.catalysis-hub.org/graphql
+- Winther et al., "Catalysis-Hub.org: An Open Electronic Structure Database for Surface Reactions," Sci. Data 6, 75 (2019). DOI: 10.1038/s41597-019-0081-y
+- SUNCAT Center: https://suncat.stanford.edu

package/skills/domains/education/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: education-skills
-description: "8 education research skills. Trigger: pedagogical research, course design, learning analytics, assessment. Design: evidence-based teaching methods and educational measurement tools."
+description: "7 education research skills. Trigger: pedagogical research, course design, learning analytics, assessment. Design: evidence-based teaching methods and educational measurement tools."
 ---
 
-# Education Research — 8 Skills
+# Education Research — 7 Skills
 
 Select the skill matching the user's need, then `read` its SKILL.md.
 
@@ -13,7 +13,6 @@ Select the skill matching the user's need, then `read` its SKILL.md.
 | [assessment-design-guide](./assessment-design-guide/SKILL.md) | Psychometrics and educational assessment design for researchers |
 | [curriculum-design-guide](./curriculum-design-guide/SKILL.md) | Systematic approaches to curriculum design using backward design and alignment |
 | [educational-research-methods](./educational-research-methods/SKILL.md) | Quantitative and qualitative research methods for education studies |
-| [edumcp-guide](./edumcp-guide/SKILL.md) | MCP server for educational content and learning management |
 | [learning-science-guide](./learning-science-guide/SKILL.md) | Evidence-based learning science principles for educational research and practice |
 | [mooc-analytics-guide](./mooc-analytics-guide/SKILL.md) | Analyzing MOOC data, learning analytics, and online education metrics |
 | [open-syllabus-api](./open-syllabus-api/SKILL.md) | Analyze most-taught books and texts via Open Syllabus analytics |

package/skills/domains/law/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: law-skills
-description: "8 legal research skills. Trigger: legal research, case law analysis, regulatory compliance. Design: legal databases, citation networks, and judicial analytics tools."
+description: "9 legal research skills. Trigger: legal research, case law analysis, regulatory compliance. Design: legal databases, citation networks, and judicial analytics tools."
 ---
 
-# Legal Research — 8 Skills
+# Legal Research — 9 Skills
 
 Select the skill matching the user's need, then `read` its SKILL.md.
 
@@ -17,3 +17,4 @@ Select the skill matching the user's need, then `read` its SKILL.md.
 | [opencontracts-guide](./opencontracts-guide/SKILL.md) | Legal document annotation, versioning, and analysis platform |
 | [patent-analysis-guide](./patent-analysis-guide/SKILL.md) | Patent search, classification, landscape analysis, and prior art mining |
 | [regulatory-compliance-guide](./regulatory-compliance-guide/SKILL.md) | Regulatory text mining, compliance research, and policy analysis tools |
+| [uk-legislation-api](./uk-legislation-api/SKILL.md) | Access UK laws and statutory instruments via the Legislation.gov.uk API |