Free AI Agent Skill for OSCAR CPAP Data

How to use the AI to find the hidden story in your OSCAR CPAP data.

Hand-drawn illustration of a bearded guy in a backwards cap and headphones at a desk with coffee, studying a trend chart on a laptop while a small friendly CPAP machine beside it proudly holds up a tiny notebook full of squiggles, with a magnifying glass and scribbled papers on the desk.

What is this?

Your CPAP machine writes detailed notes every single night. This data is yours, but it can be hard to interpret it. OSCAR, a free software program, helps by creating lots of charts, but even that can be confusing to the every day person. That's why I've created a free, research-backed AI Agent Skill that anyone can use to read their CPAP OSCAR data and turns it into a plain-language report. This is not medical advice, just information to bring up with your doctor.

The full story of why I built it is over here.

How do I use it?

Use the {file-path-to-sleep-report} Skill to interpret my OSCAR CPAP data
in my database located at {file-path-to-oscar.db}. 
Also, save this skill and db location for future use.

You will get a plain-language report that will look something like this:

The headline. Your current 30-day average AHI is 0.91 on 30 clean nights. AHI counts how many times per hour your breathing paused or shrank enough to matter; under 5 is the commonly cited goal.

Finding: higher pressure floor, slightly higher (and more central) residual events. Each time the minimum pressure was raised, the clean-night AHI average stepped up (0.92 to 1.12 to 1.19), and the share of events scored as central rose (19% to 23% to 30%). Absolute numbers remain very low throughout.

Question for your clinician: Is this expected at higher pressure, could it be a scoring artifact, and is my current pressure range still right for me?

Remember, this is not medical advice. This is for informational purposes only.

What does the Skill do?

It reads a reference file derived from the community's and clinicians' published guidance, written as rules it has to follow.

In addition it includes:

Then, it runs a Python script to read (never write) your OSCAR database data. The AI then interprets it according to the guidelines and compiles the report for you.

OSCAR Data Interpretation Guidelines

Primary Sources

Additional sources (used for supporting facts only)

Hand-drawn illustration of a friendly CPAP machine wearing glasses and waving a sparkling magic wand, sitting on a stack of textbooks labeled human anatomy, physiology, pharmacology, respiratory medicine, pathology, biochemistry, and sleep disorders.

The fine print

Again, this is not medical advice, nor a diagnostic tool. The AI's report should also not be considered medical advice and used for informational purposes only. Personally, I am not affiliated with OSCAR, Apnea Board, ResMed, or SleepHQ. This skill simply reads your data from your machine and helps you ask better questions about your sleep.