Why Do You Need a Private Health Log?
To be honest, when I used to go to the doctor for headaches and the doctor asked, "How many times have you had them recently?" I was completely blank. It felt like a lot, but the exact number, severity, and what made it better — it was all a blur in my head. Then I discovered this symptom tracking skill, and it was like finding a treasure. It's not some fancy medical app; it's a purely local tool that records using Markdown files. But this minimalism is exactly what makes me feel it's reliable — the data is entirely under my control, and I don't have to worry about privacy leaks.
First Impressions of This Skill
The installation steps are super simple, just one command: npx skills add some-repository-url --skill symptoms. Then you'll find a ~/Clawic/data/symptoms/ folder created in your Home directory. Open it, and the structure is so clear it's comforting —
~/Clawic/data/symptoms/
├── log/
│ └── 2024/
├── patterns.md
├── for-doctor/
└── medications.md
Each part has a clear role: log stores daily records by year, patterns.md is an auto-generated pattern analysis, for-doctor is a summary for the doctor, and medications.md records medications (but the skill won't recommend drugs; it only records what you say you've taken).
Hands-On: Recording a Headache
I tried simulating a record. In log/2024/02/11.md, I wrote the following:
## 8:30 AM — Headache
Severity: 6/10
Location: Right temple, behind eye
Character: Throbbing
Started: ~8:00 AM
Context: 5h sleep, no caffeine yet, high stress
Associated: Slight nausea, light sensitivity
Previous: Similar last Tuesday
Tried: Nothing yet
After writing it, I felt completely clear! Because before, when the doctor asked "What does the headache feel like?" all I could say was "it just hurts," but now I can tell them precisely: it's throbbing, located behind my right temple, accompanied by nausea and light sensitivity. And I also recorded the context: only 5 hours of sleep, no coffee, high stress. This kind of information is really helpful for diagnosis.
How the Skill Helps You Discover Patterns
The most surprising thing about this skill is its "proactiveness." When you record a symptom, it follows up like a doctor: where exactly does it hurt? Does it spread? Dull or stabbing? On a scale of 1 to 10? When did it start? Has it worsened? What were you doing at the time? How much did you sleep yesterday? What did you eat? Any other discomfort? Has this happened before? What have you tried? It turns all of this into structured fields.
What's even more impressive is that it follows up automatically: it asks "Any change?" two hours later, "How did it get better?" if the symptom resolved, and "Did it recur?" the next day. When you've recorded the same symptom more than three times, it summarizes in patterns.md: "This month, there were 3 headaches, all occurring in the morning on days with high work stress and insufficient sleep." This kind of pattern recognition is far more reliable than guessing on your own.
Preparing a "Cheat Sheet" for the Doctor
Before my last doctor's visit, I went to for-doctor/appointment-2024-02-15.md and generated this summary:
## Summary (Last 30 Days)
- Headaches: 4 episodes, severity 4-7/10
- Pattern: Mornings, after poor sleep
- Helps: caffeine, dark room
- Worsens: bright lights
Just a few lines, and the doctor could see it at a glance. After reading it, he directly said: "Typical tension headache. Focus on improving sleep and reducing screen time." The whole process took less than 5 minutes. I didn't have to recall on the spot, and the doctor didn't have to ask repeatedly. That's efficient doctor-patient communication.
Important Reminder: It's Not a Doctor
I must emphasize: this skill is just a recording and organizing tool. It does not diagnose "you might have migraines," does not recommend what medications to take, and does not say "it's nothing serious." Its role is simply to help you faithfully record your body's manifestations and then organize them into a format the doctor needs. If you encounter a sudden severe symptom, difficulty breathing, chest pain, or persistent high fever, seek medical attention immediately. Do not rely on any tool. Health is no trivial matter; recording is for better cooperation, not for replacing professional judgment.
Some Tips for Using the Skill
- Keep daily records: Even if you feel normal, write "no abnormalities today" so the pattern analysis is more complete.
- Make good use of context: Record diet, sleep, mood, exercise, etc. These are often triggers.
- Review regularly: Look at
patterns.mdonce a month. You'll be surprised to find many hidden patterns. - Before a doctor's visit: Start preparing the summary a week in advance and mark the important entries.
Conclusion
I've been using this skill for two months now, and I can't live without it. It has helped me shift from a state of "only worrying when something goes wrong with my body" to "continuously monitoring my health..."