A tool to help users organize symptoms, records, medications, and questions before medical visits, while offering clear explanations of examination reports and cautious risk reminders—without diagnosing, prescribing, or replacing professional care.
Documents
symptom-timeline
Try itTrack symptoms over time and generate doctor-ready timelines. Correlates symptoms with food, weather, medication, activity, sleep, and stress. Detects patterns, flare-ups, and produces concise clinical reports.
What it does
Track symptoms over time and generate doctor-ready timelines. Correlates symptoms with food, weather, medication, activity, sleep, and stress. Detects patterns, flare-ups, and produces concise clinical reports.
The skill document
Symptom Timeline
Track symptoms over time. Find what triggers them. Generate doctor-ready reports.
Quick Start
# Log a symptom with triggers
python3 scripts/symptom_tracker.py log \
--name headache \
--severity 7 \
--triggers "poor sleep,stress,caffeine"
# View all entries chronologically
python3 scripts/symptom_tracker.py timeline
# Find what triggers your symptoms
python3 scripts/symptom_tracker.py correlate
# Get a doctor-ready summary
python3 scripts/symptom_tracker.py summary
# Export a plain-text report for your appointment
python3 scripts/symptom_tracker.py export --output report.txt
Commands
| Command | Description |
|---|---|
log | Record a symptom (name, severity 1-10, time, notes, triggers) |
timeline | Show chronological log, optionally filtered by name or date range |
correlate | Detect trigger-symptom patterns and co-occurring symptoms |
summary | Generate a doctor-ready report with trends and triggers |
flare-up | Detect worsening patterns (consecutive high severity, sudden jumps) |
heatmap | ASCII severity heatmap over days/weeks |
export | Export a plain-text report for a doctor visit |
Trigger Categories
The script auto-categorizes triggers into:
- food — meals, dairy, gluten, caffeine, alcohol, etc.
- stress — anxiety, work pressure, deadlines
- weather — humidity, barometric pressure, temperature
- medication — drugs, doses, missed medications
- sleep — insomnia, poor sleep, fatigue
- activity — exercise, prolonged sitting/standing
You can also use explicit prefixes: food:dairy, weather:high humidity.
Data Storage
All data is stored in symptom_db.json (in the skill directory by default).
Use --db /path/to/file.json to specify a custom location.
References
- Symptom Tracking Guide — what to track for common conditions
- Doctor Visit Prep — how to present symptoms effectively
Related skills
Log meals from photos, text, or labels and get ranged calorie and macro estimates with built-in safety guardrails.
by Iván53 installs3 stars
Track intermittent and extended fasts from last caloric intake, with stage estimates, electrolyte prompts, and scaled refeeding guidance.
47 installs2 stars
Track menstrual cycle history, answer current cycle status questions, record new period start dates from natural-language messages such as "月经来了", predict th...
17 installs
Track sleep vs optimal, calculate accumulated sleep debt, and suggest evidence-based recovery schedules. Chronotype detection, quality-weighted sleep tracking, ASCII charts, and caffeine/alcohol impact monitoring.
1 installs
Smart water intake tracking based on body weight, weather, and activity level. Calculates personalized hydration targets, adjusts for caffeine and alcohol consumption, tracks streaks with gamification, generates hourly drinking schedule, and provides hydration education with urine color chart reference.