scaffolding-smart-on-fhir

Scaffold SMART-on-FHIR apps using OAuth2 PKCE and retrieve patient clinical notes.

5.0k|615|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/maziyarpanahi/openmed --skill scaffolding-smart-on-fhir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffolding-smart-on-fhir
Source: https://github.com/maziyarpanahi/openmed/tree/main/skills/scaffolding-smart-on-fhir
Command: npx skills add https://github.com/maziyarpanahi/openmed --skill scaffolding-smart-on-fhir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps build clinician-facing applications that securely connect to EHR systems through SMART-on-FHIR, obtain scoped patient context, and process clinical notes with OpenMed locally instead of sending PHI to a cloud service.

Core Features & Use Cases

  • SMART App Launch: Supports both EHR launch and standalone launch flows for Epic and Cerner/Oracle Health.
  • OAuth2 Security: Implements SMART App Launch v2 discovery, authorization code exchange, PKCE, state validation, token handling, and minimum-necessary scopes.
  • FHIR Clinical Data: Fetches patient context and clinical notes from DocumentReference resources, then applies local de-identification and biomedical named-entity recognition with OpenMed.
  • Production Guidance: Covers scope downgrades, token expiration, app registration, browser PHI handling, and interoperability hand-offs to FHIR validation and bundle workflows.

Quick Start

Ask the skill to scaffold a SMART-on-FHIR app for Epic that uses OAuth2 PKCE to fetch the current patient's clinical notes, de-identify them locally with OpenMed, and display the extracted entities.

Frequently Asked Questions about scaffolding-smart-on-fhir

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a SMART on FHIR app that retrieves clinical notes from Epic?

To build a SMART on FHIR app for Epic, you scaffold an application that uses SMART App Launch v2 discovery, OAuth2 PKCE authorization, and DocumentReference retrieval to securely fetch and process patient clinical notes locally.

What is the best way to handle EHR integration without sending PHI to a cloud service?

The best way to handle EHR integration without sending PHI to a cloud service is to fetch clinical notes via FHIR and process them locally, applying de-identification and biomedical named-entity recognition before any data leaves the browser environment.

Does SMART App Launch v2 support both EHR launch and standalone flows for Cerner?

Yes, SMART App Launch v2 supports both EHR launch and standalone launch flows for Cerner and Oracle Health, handling OAuth2 authorization code exchange, PKCE, state validation, and minimum-necessary scoped access tokens.

How do I de-identify FHIR DocumentReference resources for local clinical NER?

To de-identify FHIR DocumentReference resources for local clinical NER, you retrieve the patient context and clinical notes, then apply local de-identification techniques before processing the text with OpenMed for biomedical named-entity recognition.

What are the limitations of browser PHI handling in clinician-facing SMART applications?

Limitations of browser PHI handling include managing scope downgrades, token expiration, and app registration requirements, requiring strict privacy-conscious handling to prevent exposing protected health information during interoperability hand-offs and FHIR validation workflows.