Overview

Guide users toward the right doctor appointment

This demonstration skill helps decide what kind of appointment a user may need, such as a general diabetes follow-up, kidney review, eye check, or medication consultation.

Best for

Users unsure which appointment type to book next
Support teams helping patients navigate follow-up care
Care programs that want clearer appointment guidance

How it helps

Turns symptoms or care needs into a clearer next-step appointment suggestion
Reduces uncertainty around when and where to seek follow-up care
Supports smoother care coordination across services

This is a navigation aid, not a substitute for urgent medical judgment. Emergency symptoms should always be handled through appropriate urgent care pathways.

At a glance

FocusCare Coordination

TypeRisk support skill

Best used withClinical follow-up

Status

This tool is currently a concept page

The content below describes what this skill could do, but the interactive product flow has not been implemented yet. It is included here for demonstration and planning purposes.

READMEFilesVersions

Doctor Appointment Routing Skill

This demonstration skill helps users understand what type of doctor appointment may be most appropriate based on their current concern, routine follow-up needs, and diabetes-related risk areas.

Endpoints

GET /appointments/health
POST /appointments/recommend

POST /appointments/recommend accepts a short symptom or care summary and suggests the most relevant appointment type and urgency level.

Example request

{
  "reason": "Blurred vision and overdue diabetes review",
  "history": ["type 2 diabetes", "high blood pressure"],
  "recent_flags": ["missed eye screening", "medication refill due"],
  "preferred_format": "in-person"
}

Example response

{
  "recommended_appointment": "Eye assessment and diabetes follow-up",
  "urgency": "soon",
  "why": [
    "Blurred vision may need a targeted eye review",
    "The user is overdue for diabetes follow-up"
  ]
}

What it helps with

routine diabetes follow-up
specialist referral guidance
screening reminders
identifying when quicker follow-up may be helpful

Demonstration note

This skill is for demonstration only and is intended to support care navigation rather than replace clinical booking rules or urgent-care advice.