Emergency Medical Information Card Generator

Generate a medical-information summary for quick access in an emergency, for first aid or seeking care.

Core Functions

1. Emergency-information extraction

Extract the most critical information from the user's health data:

• Severe allergies: prioritize level 4 (anaphylaxis) and level 3 allergies
• Current medications: names, doses, and frequencies of active drugs
• Acute conditions: medical conditions needing emergency handling
• Implants: pacemakers, stents, etc. (affect imaging and treatment)
• Emergency contacts: family contacts for quick reach

2. Information-priority ranking

Rank information by medical urgency:

1. P0 - critical: anaphylaxis, severe drug allergy, life-threatening disease
2. P1 - important: current medications, chronic disease, implants
3. P2 - general: blood type, age, weight, recent exams

3. Multi-format output

Supports multiple output formats for different scenarios:

• HTML: printable web page using Tailwind CSS and Lucide icons (recommended)
• JSON: structured data for system integration
• Text: concise and readable, good for printing and carrying
• PDF: professional printing, good for long-term keeping

#### HTML format (new) Generates a standalone HTML file including:

• Tailwind CSS styling (via CDN)
• Lucide icons (via CDN)
• Responsive design
• Print optimization
• Multiple size variants (A4, wallet card, large-print)
• Automatic card-type detection (standard, child, elderly, severe allergy)

Usage:

# Generate a standard card
python scripts/generate_emergency_card.py

# Specify card type
python scripts/generate_emergency_card.py standard
python scripts/generate_emergency_card.py child
python scripts/generate_emergency_card.py elderly
python scripts/generate_emergency_card.py severe

# Specify print size
python scripts/generate_emergency_card.py standard a4       # A4 standard
python scripts/generate_emergency_card.py standard wallet   # wallet card
python scripts/generate_emergency_card.py standard large    # large-print (elderly)

Output file: emergency-cards/emergency-card-{variant}-{YYYY-MM-DD}.html

4. Offline availability

• Save to phone (photos, files)
• Print and carry (wallet, bag)
• Cloud backup (optional)

Usage

Triggers

Use this skill when the user mentions scenarios such as:

• ✅ "Generate an emergency medical card"
• ✅ "I'm traveling how do I provide medical info quickly?"
• ✅ "Put my allergy info into a card"
• ✅ "Emergency first-aid info"
• ✅ "Appointment-preparation materials"
• ✅ "Medical-information summary"

Execution Steps

#### Step 1: Read the user's base data Read information from the following data sources:

// 1. User profile
const profile = readFile('data/profile.json');

// 2. Allergy history
const allergies = readFile('data/allergies.json');

// 3. Current medications
const medications = readFile('data/medications/medications.json');

// 4. Radiation records
const radiation = readFile('data/radiation-records.json');

// 5. Surgery records (find implants)
const surgeries = glob('data/surgery-records/**/*.json');

// 6. Discharge summaries (find acute conditions)
const dischargeSummaries = glob('data/discharge-summaries/**/*.json');

#### Step 2: Extract key information

##### 2.1 Basic info

const basicInfo = {
  name: profile.basic_info?.name || "Not set",
  age: calculateAge(profile.basic_info?.birth_date),
  gender: profile.basic_info?.gender || "Not set",
  blood_type: profile.basic_info?.blood_type || "Unknown",
  weight: `${profile.basic_info?.weight} ${profile.basic_info?.weight_unit}`,
  height: `${profile.basic_info?.height} ${profile.basic_info?.height_unit}`,
  bmi: profile.calculated?.bmi,
  emergency_contacts: profile.emergency_contacts || []
};

#### 2.2 Severe allergies

// Filter level 3-4 severe allergies
const criticalAllergies = allergies.allergies
  .filter(a => a.severity_level >= 3 && a.current_status.status === 'active')
  .map(a => ({
    allergen: a.allergen.name,
    severity: `allergy ${getSeverityLabel(a.severity_level)} (level ${a.severity_level})`,
    reaction: a.reaction_description,
    diagnosed_date: a.diagnosis_date
  }));

#### 2.3 Chronic-disease diagnoses (new)

// Extract diagnoses from chronic-disease management data
const chronicConditions = [];

// Hypertension
try {
  const hypertensionData = readFile('data/hypertension-tracker.json');
  if (hypertensionData.hypertension_management?.diagnosis_date) {
    chronicConditions.push({
      condition: 'Hypertension',
      diagnosis_date: hypertensionData.hypertension_management.diagnosis_date,
      classification: hypertensionData.hypertension_management.classification,
      current_bp: hypertensionData.hypertension_management.average_bp,
      risk_level: hypertensionData.hypertension_management.cardiovascular_risk?.risk_level
    });
  }
} catch (e) {
  // File missing or read failed  skip
}

// Diabetes
try {
  const diabetesData = readFile('data/diabetes-tracker.json');
  if (diabetesData.diabetes_management?.diagnosis_date) {
    chronicConditions.push({
      condition: diabetesData.diabetes_management.type === 'type_1' ? 'Type 1 diabetes' : 'Type 2 diabetes',
      diagnosis_date: diabetesData.diabetes_management.diagnosis_date,
      duration_years: diabetesData.diabetes_management.duration_years,
      hba1c: diabetesData.diabetes_management.hba1c?.history?.[0]?.value,
      control_status: diabetesData.diabetes_management.hba1c?.achievement ? 'Well controlled' : 'Needs improvement'
    });
  }
} catch (e) {
  // File missing or read failed  skip
}

// COPD
try {
  const copdData = readFile('data/copd-tracker.json');
  if (copdData.copd_management?.diagnosis_date) {
    chronicConditions.push({
      condition: 'COPD',
      diagnosis_date: copdData.copd_management.diagnosis_date,
      gold_grade: `GOLD grade ${copdData.copd_management.gold_grade}`,
      cat_score: copdData.copd_management.symptom_assessment?.cat_score?.total_score,
      exacerbations_last_year: copdData.copd_management.exacerbations?.last_year
    });
  }
} catch (e) {
  // File missing or read failed  skip
}

#### 2.4 Current medications

// Include active drugs only
const currentMedications = medications.medications
  .filter(m => m.active === true)
  .map(m => ({
    name: m.name,
    dosage: `${m.dosage.value}${m.dosage.unit}`,
    frequency: getFrequencyLabel(m.frequency),
    instructions: m.instructions,
    warnings: m.warnings || []
  }));

##### 2.4 Medical conditions Extract diagnoses from discharge summaries:

const medicalConditions = dischargeSummaries
  .flatMap(ds => {
    const data = readFile(ds.file_path);
    return data.diagnoses || [];
  })
  .map(d => ({
    condition: d.condition,
    diagnosis_date: d.date,
    status: d.status || "In follow-up"
  }));

##### 2.5 Implants Extract implant info from surgery records:

const implants = surgeries
  .flatMap(s => {
    const data = readFile(s.file_path);
    return data.procedure?.implants || [];
  })
  .map(i => ({
    type: i.type,
    implant_date: i.date,
    hospital: i.hospital,
    notes: i.notes
  }));

##### 2.6 Recent radiation exposure

const recentRadiation = {
  total_dose_last_year: calculateTotalDose(radiation.records, 'last_year'),
  last_exam: radiation.records[radiation.records.length - 1]
};

#### Step 3: Build the information card

Organize information by priority:

const emergencyCard = {
  version: "1.0",
  generated_at: new Date().toISOString(),
  basic_info: basicInfo,
  critical_allergies: criticalAllergies.sort(bySeverityDesc),
  current_medications: currentMedications,
  medical_conditions: [...medicalConditions, ...chronicConditions], // merge acute and chronic
  implants: implants,
  recent_radiation_exposure: recentRadiation,
  disclaimer: "This card is for reference only and does not replace professional medical diagnosis",
  data_source: "personal health information system",
  chronic_conditions: chronicConditions // separate field for easy access
};

#### Step 4: Format the output

##### JSON format Output structured JSON directly.

##### Text format Generate a readable text card:

╔═══════════════════════════════════════════════════════════╗
║                  EMERGENCY MEDICAL CARD                   ║
╠═══════════════════════════════════════════════════════════╣
║ Name: John Doe                  Age: 35                  ║
║ Blood type: A+                  Weight: 70kg            ║
╠═══════════════════════════════════════════════════════════╣
║ 🆘 SEVERE ALLERGIES                                      ║
║ ─────────────────────────────────────────────────────── ║
║ • Penicillin - anaphylaxis (level 4) 🆘                 ║
║   Reaction: difficulty breathing, laryngeal edema,      ║
║   loss of consciousness                                  ║
╠═══════════════════════════════════════════════════════════╣
║ 💊 CURRENT MEDICATIONS                                   ║
║ ─────────────────────────────────────────────────────── ║
║ • Amlodipine 5mg - once daily (hypertension)            ║
║ • Metformin 1000mg - twice daily (diabetes)             ║
╠═══════════════════════════════════════════════════════════╣
║ 🏥 CHRONIC CONDITIONS                                    ║
║ ─────────────────────────────────────────────────────── ║
║ • Hypertension (dx 2023-01-01, grade 1, controlled)     ║
║   Average BP: 132/82 mmHg                               ║
║ • Type 2 diabetes (dx 2022-05-10, HbA1c 6.8%)          ║
║   Control: good                                          ║
║ • COPD (dx 2020-03-15, GOLD grade 2)                    ║
║   CAT score: 18                                         ║
╠═══════════════════════════════════════════════════════════╣
║ 🏥 OTHER CONDITIONS                                      ║
║ ─────────────────────────────────────────────────────── ║
║ (other acute or surgical diagnoses, if any)             ║
╠═══════════════════════════════════════════════════════════╣
║ 📿 IMPLANTS                                              ║
║ ─────────────────────────────────────────────────────── ║
║ • Pacemaker (implanted 2022-06-10)                      ║
║   Hospital: XX Hospital                                  ║
║   Note: regular checks, avoid MRI                       ║
╠═══════════════════════════════════════════════════════════╣
║ 📞 EMERGENCY CONTACT                                     ║
║ ─────────────────────────────────────────────────────── ║
║ • Jane Doe (spouse) - 138****1234                       ║
╠═══════════════════════════════════════════════════════════╣
║ ⚠️  DISCLAIMER                                          ║
║ This card is for reference only and does not replace     ║
║ professional medical diagnosis                           ║
║ Generated: 2025-12-31 12:34:56                          ║
╚═══════════════════════════════════════════════════════════╝

##### QR-code format Convert the JSON data to a QR-code image:

const qrCode = generateQRCode(JSON.stringify(emergencyCard));
emergencyCard.qr_code = qrCode;

#### Step 5: Save files

Save files in the format the user chose:

// JSON
saveFile('emergency-card.json', JSON.stringify(emergencyCard, null, 2));

// Text
saveFile('emergency-card.txt', generateTextCard(emergencyCard));

// QR code
saveFile('emergency-card-qr.png', emergencyCard.qr_code);

#### Step 6: Output a confirmation

✅ Emergency medical card generated

File location: data/emergency-cards/emergency-card-2025-12-31.json
Generated: 2025-12-31 12:34:56

Includes:
━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Basic info (name, age, blood type)
✓ Severe allergies (1 level-4 allergy)
✓ Current medications (2 drugs)
✓ Medical conditions (2 diseases)
✓ Implants (1)
✓ Emergency contact (1)

💡 Usage tips:
━━━━━━━━━━━━━━━━━━━━━━━━━━
• Save the JSON file to your phone's cloud drive
• Save the QR code to your phone's photos
• Print the text version and carry it
• Update before traveling

⚠️  Notes:
━━━━━━━━━━━━━━━━━━━━━━━━━━
• This card is for reference only and does not replace professional medical diagnosis
• Update regularly (every 3 months or after health-info changes)
• If you have a severe allergy, also carry an allergy first-aid card

Data Sources

Primary data sources

• data/profile.json: basic info, blood type, emergency contacts
• data/allergies.json: allergy history and severity grading
• data/medications/medications.json: current medication plan and doses

Chronic-disease data sources (new)

• data/hypertension-tracker.json: hypertension management (diagnosis date, grade, BP control, target-organ damage, cardiovascular risk)
• data/diabetes-tracker.json: diabetes management (type, HbA1c, glucose control, complication screening)
• data/copd-tracker.json: COPD management (GOLD grade, CAT score, exacerbation history, lung function)

Auxiliary data sources

• data/radiation-records.json: recent radiation-exposure records
• data/surgery-records//.json*: surgical-implant information
• data/discharge-summaries//.json*: medical-diagnosis information

Optional data sources

• data/index.json: global data index

Safety Principles

Must follow

• ❌ Do not add medication advice (only list current medications)
• ❌ Do not provide diagnostic conclusions (only list known diagnoses)
• ❌ Do not give treatment advice (does not replace a physician)
• ❌ Include a disclaimer (for reference only)

Information accuracy

• ✅ Only extract recorded information (no guessing or inference)
• ✅ Note the data source and update time
• ✅ Recommend updating information regularly

Privacy protection

• ✅ Sensitive info can be hidden optionally
• ✅ Phone numbers partly hidden (e.g., 138****1234)
• ✅ All data is stored locally only

Error Handling

Missing data

• Missing allergy data: output "No allergy history recorded"
• Missing medication data: output "No current medications recorded"
• Missing implant data: output "No implants"

File-read failure

• Cannot read profile.json: use defaults (name: Not set)
• Cannot read allergies.json: skip allergy info
• Continue generating other info: do not abort because one file fails

QR-code generation failure

• Fall back to text output
• Prompt the user to record info manually

Example Output

For a full example, see examples.md.

Test Data

The test-data file is at test-data/emergency-example.json.

Format Notes

For detailed output-format notes, see formats.md.