Symptom Scorer Skill

SkillCommunication

Use this skill during pre-diagnosis triage (clinic_agent) to assign a structured severity score (0–100) and triage colour (RED/YELLOW/GREEN) to the user's reported symptoms. Invoke automatically when the user has described at least one symptom. The score drives urgency messaging: RED means call 120 immediately, YELLOW means same-day visit, GREEN means watchful waiting. Always show triggered_flags to the user.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Symptom Scorer Skill skill

What this skill tells your AI

The instructions your AI receives, as published by wananing/smart-health-assistant in backend/skills/symptom_scorer/SKILL.md and read by ahel’s review.

Rule-based clinical triage engine that evaluates free-text symptom descriptions against a library of red-flag and yellow-flag patterns, fever thresholds, duration escalation rules, pain scores, and age-specific risk weights.

Scoring Axes

  1. Red-flag keywords — life-threatening signs (chest pain, stroke, severe allergy) → +60 per flag
  2. Yellow-flag keywords — urgent but non-emergency signs → +20 per flag
  3. Fever temperature — parsed from free text (38°C → +8 … ≥40°C → +40)
  4. Symptom duration — >3 days +10, >7 days +20, >2 weeks +30, >1 month +40
  5. Pain scale (NRS 0–10) — mild +8, moderate +15, severe +30
  6. Age modifiers — <3, >75 years → +15; <12, >65 years → +8

Final score is capped at 100.

Required Inputs

  • symptoms_text — raw symptom description from the user (Chinese or English)

Optional Inputs

  • pain_scale — 0–10 NRS self-reported pain score
  • duration_days — symptom duration in days (auto-parsed from text if omitted)
  • age — patient age for risk weighting

Triage Thresholds

ScoreColourAction
≥70 or critical flag🔴 REDCall 120 immediately
35–69🟡 YELLOWSee doctor within 4–8 hours
0–34🟢 GREENWatchful waiting 1–3 days

Agent Instructions

  • Always display triage_label and recommended_action prominently
  • List every item in triggered_flags — these explain the urgency to the user
  • Show disclaimer below the assessment
  • If RED: lead with the emergency call-to-action before any other text

Signals

GitHub stars
21
Forks
4
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
symptom-scorer
Source
github.com/wananing/smart-health-assistant