Personal Health Record — Development skill for Claude Code

Personal Health Record — Claude Code Skill

A skill for [Claude Code](https://claude.ai/code) that helps you organize and analyze your personal medical documents: lab results, doctor visits, imaging studies (MRI, CT, ultrasound, ECG), discharge summaries, prescriptions, and vaccination records.

Supports **Russian and English** documents. All extracted data is stored locally on your machine.

---

What it does

**Add documents** — share a medical PDF with Claude in any way that's convenient: attach it in chat, give a local file path, or load it from a cloud service via MCP. Claude reads the document, extracts all structured data, and saves it to a local archive.

**Ask questions in plain language:**

• "What was my hemoglobin last January?"
• "Show all diagnoses from the past two years"
• "Have I ever been prescribed metformin?"
• "Show my cholesterol trend"
• "When did I last see a cardiologist?"

**Timeline and trends** — get a chronological view of your medical history or track how any lab indicator changes over time.

**Export** — export your data to CSV at any time.

---

How it works

Every document goes through three layers stored in a folder of your choice:

your-archive/
├── archive_owner.json    # who this archive belongs to (created automatically)
├── original_files/       # original files, stored unchanged
├── json_extractions/     # full structured extraction of each document
└── structured_database/
    ├── medical.db        # SQLite database — fast queries across all documents
    └── errors.log        # one line per failed ingest

When you ask a question, Claude queries the database first. No re-reading PDFs on every question.

---

Requirements

• Claude Code installed
• Python 3.10 or newer (standard library only — no packages to install)

---

Installation

Option 1 — One command (no git required)

Open Terminal and run:

curl -fsSL https://raw.githubusercontent.com/romahakov/personal-heal