Symptoms

Overview

Symptoms provides a private, on-device way to log health patterns and prepare for doctor visits. It uses a dedicated ~/symptoms workspace with structured folders to store logs, patterns, and doctor-ready notes, while keeping all data on your device and never syncing.

How This Skill Works

When you report a symptom, it prompts detailed follow-up questions to capture location, severity, onset, and context. Entries are saved in Markdown under ~/symptoms/log with a consistent format, patterns.md tracks recurring clues, and red-flag prompts surface urgent care needs; a for-doctor folder keeps appointment-ready summaries, and medications.md can house current meds as part of your private record.

When to Use It

• You notice recurring headaches and want to track patterns across days to identify triggers like sleep or stress.
• You’re preparing for a doctor visit and need a concise, organized summary of the last 30 days.
• A new symptom appears after physical activity or caffeine intake and you want to log context and response.
• You’ve had poor sleep or high stress and want to correlate symptoms with sleep quality and hydration.
• You want to surface red flags early (severe symptoms, breathing issues) and know when to seek care.

Quick Start

1. Step 1: Create the workspace at ~/symptoms and verify subfolders log/, patterns.md, for-doctor/, and medications.md exist.
2. Step 2: Add a sample log entry using the provided Markdown format to start tracking a symptom (e.g., Headache with severity and context).
3. Step 3: Review patterns.md and prepare a brief appointment summary in for-doctor/ ahead of your next visit.

Best Practices

• Answer follow-up questions thoroughly to build a complete symptom picture.
• Keep entries in the provided Markdown format under ~/symptoms/log for consistency.
• Regularly review patterns.md to spot triggers and discuss them with your clinician.
• Use the for-doctor/ folder to export a structured appointment summary before visits.
• Remember this tool is for documentation only—never diagnose or prescribe; defer to professionals.

Example Use Cases

• Logged a 6/10 right-temple headache with location, duration, and nausea, then noted sleep quality and caffeine use to correlate triggers.
• Created a 30-day summary in for-doctor/appointment-2024-02-15.md showing frequency, pattern (mornings after poor sleep), and relief factors like darkness and reduced light.
• Proactively added two-hour follow-ups:Asked about changes and documented any improvements or new symptoms.
• Flagged red-flag symptoms (severe chest pain) to prompt immediate care when surface prompts appear.
• Maintained a local log without syncing, ensuring privacy while building a doctor-ready history.

Frequently Asked Questions