OpenEvidence Hello World Skill

OpenEvidence Hello World

Overview

Minimal working examples demonstrating core OpenEvidence API functionality.

Instructions

Step 1: Clinical Query

const result = await client.query({
  question: 'What is the recommended treatment for acute migraine in adults?',
  context: 'emergency_department',
  evidence_level: 'high',  // Filter by evidence quality
  max_citations: 10
});

console.log('Answer:', result.answer);
console.log('Confidence:', result.confidence);
result.citations.forEach(c =>
  console.log(`  [${c.journal}] ${c.title} (${c.year}) — ${c.evidence_level}`)
);

Step 2: Drug Interaction Check

const interactions = await client.interactions.check({
  medications: ['metformin', 'lisinopril', 'atorvastatin'],
  patient_context: { age: 65, conditions: ['diabetes', 'hypertension'] }
});

interactions.forEach(i =>
  console.log(`${i.drug1} + ${i.drug2}: ${i.severity} — ${i.description}`)
);

Step 3: Guideline Lookup

const guidelines = await client.guidelines.search({
  condition: 'hypertension',
  source: ['ACC/AHA', 'ESC'],
  year_min: 2023
});
guidelines.forEach(g =>
  console.log(`${g.source}: ${g.title} (${g.year})`)
);

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | Auth error | Invalid credentials | Check OPENEVIDENCE_API_KEY | | Not found | Invalid endpoint | Verify API URL | | Rate limit | Too many requests | Implement backoff |

Resources

OpenEvidence API Docs

Next Steps

See openevidence-local-dev-loop.

Agent Skills: OpenEvidence Hello World

Install this agent skill to your local

Skill Files