Musings on healthcare IT, FHIR, EHR systems, and digital health innovation

🔥 FHIR in the hole!
Back to posts

Questionnaire Everything

Original on LinkedIn

Every clinic visit still involves filling out forms: your name, your address, your medications, your allergies, how your back has felt over the past two weeks. Much of it the clinic already has, or could look up, but a form on paper has no way to ask the rest of the health system what it knows… and electronic forms are often no better.

Kill The Clipboard is working to fix that. My recent July 2026 update describes where things stand: when a patient shares their medications, allergies, problems, and immunizations from an app, the receiving EHR is now required to save that structured data into the chart, alongside any PDFs the patient sends. That handles the questions repeated at every visit. It does not handle the visit-specific ones: the reason-for-visit questions, the symptom questionnaires, the social-needs questions a particular clinic decided to ask. Those exist because a specific clinic, on a specific day, needs a specific answer, and there is still no interoperable way for the clinic to ask or for your app to answer. So you still fill them in by hand.

Closing that gap takes a check-in protocol, where the clinic tells your app what this visit needs and your app answers back; a working prototype, SMART Health Check-in, already exists. But a protocol needs something to carry: the clinic’s actual forms, in a format an app can render and return. The worry has been that getting forms into that shape is itself a major undertaking. So I tested it.

I built a conversion pipeline and pointed it at a pile of real forms. An AI agent gathered 224 intake and follow-up forms published by hospitals, professional societies, and state health agencies: PDFs, web forms, whatever it found. The pipeline turned them into 72 FHIR Questionnaires, the health-data standard’s format for a fillable form that software can render and score. (224 collapses to 72 because many sites post the same instruments, and some harvested files were not forms at all.)

The forms came in two kinds. About two-thirds were standardized instruments: named, published questionnaires such as the PHQ-9 depression screen or the Oswestry back-pain index, identical wherever they appear. The rest were local: one practice’s own new-patient packet, particular to that clinic. They share no common structure; each has its own sections, its own answer scales, its own skip logic where one answer hides or reveals later questions.

The pipeline does not try to flatten that variety. An AI agent converts each form as it actually is, wording, branching logic, scoring, and all. A deliberately small slice of the standard, well supported and free of its more speculative features, keeps every result as plain, portable data any patient app can open.

I packaged this whole pipeline as a “questionnaire-everything” SKILL.md that any AI agent can load: instructions distilled from the conversion experiment, plus runnable scripts for writing and validating FHIR Questionnaires, all open and freely licensed. Point an AI agent equipped with the skill at a folder of anything, a clinic’s real and idiosyncratic mix of intake packets and follow-up sheets, and it produces Questionnaires that plug into a KTC check-in workflow. The 72 converted forms are just the evidence that it works. A practice with one technically minded person can run its own forms through it and review the drafts; the first pass surfaces the rough edges, and after that, adding or updating a form is routine.

Converting the forms is one thing; filling them is another. I ran a second pass over the 72 Questionnaires, all 1,980 answerable questions in them, sorting each by whether it could be filled automatically from a reasonably complete health record or genuinely needs the patient at the moment of the visit. There are two very different patterns.

  • Across 22 real provider intake packets, about 87% of questions are answerable from data a record already holds: name, address, insurance, medications, allergies, problems, prior procedures. The record-fillable side is also largely covered already: the medications, allergies, problems, and immunizations in the July 2026 scope, plus basic demographics, account for roughly two-thirds of them. (A clinic’s intake form has two layers: a shell the patient’s own record can fill, and a smaller surface of genuine per-visit input. The data for the first layer is already moving.)
  • Across the standardized symptom questionnaires it drops to about 5%, because those ask how you feel right now, and only you can answer that

None of this means the clipboard is solved. EHRs still have to do the integration work to receive and route answers. Clinics still have to adopt check-in tooling. Patients still need an app they trust, of their own choosing, to hold their data and facilitate sharing. But converting a clinic’s forms, long treated as a barrier to even starting, is not the hard part. It takes a folder of forms, an AI agent with the right skill, and an afternoon of review.

The skill, the 72 example Questionnaires, and the source forms are all at github.com/jmandel/fhir-questionnaires-from-the-web, with a browsable catalog at joshuamandel.com/fhir-questionnaires-from-the-web.

Conversation on LinkedIn

7 comments · 106 reactionsReply on LinkedIn
  • Josh Mandel, MDAuthorMay 23, 2026

    Thanks Zac Jiwa for the inspiration to put this together :)

    4 reactions

  • Shahid ShahMay 24, 2026

    Gov’t, Health, LifeSci and MedTech Researcher & Author | HealthcareNOW Radio and HealthIMPACT Host

    This is great, your ideas coupled with NIH's LHC-Forms open source package, AI + agents + humans can throw together complex questionnaires pretty quickly!

    3 reactions

  • Uri GorenMay 24, 2026

    Head of Innovation @Meir | Leading patient-centric innovation with AI and design thinking expertise.

    ‏‏Eyal Dviri‏‏

  • Mark BegaleMay 24, 2026

    Vice President at Vibrent Health

    This seems familiar ;).

    2 reactions

  • William LaolagiMay 26, 2026

    Interoperability specialist serving the state of California in Riverside and San Bernardino counties

    This just sparked a crazy idea, thanks Josh Mandel, MD

    1 reaction

  • Reuven SchnaiderMay 26, 2026

    Senior Project Manager | Healthcare Interoperability | FHIR | AI | Digital Health Innovation

    This is a very interesting direction, especially for reducing the “clipboard problem” in healthcare.
    My main concern is less about the technical conversion itself, and more about the governance around it.
    When AI converts PDFs, screenshots, or HTML forms into FHIR Questionnaires, two risks become critical:

    1. Security & privacy - making sure no PHI is exposed to unauthorized AI services, prompts, logs, or intermediate storage.

    2. AI hallucinations - a Questionnaire can be FHIR-valid but still clinically wrong: incorrect skip logic, invented fields, wrong terminology mapping, or assumptions that were not in the source form.



    In healthcare, especially in complex domains like oncology, the output should be treated as a draft that requires strong validation, auditability, and clinical review.
    FHIR-valid is not the same as clinically safe.

    1 reaction

  • Bret Heale, PhDMay 29, 2026 · edited

    Solutions Architect, Precision Medicine, Biomedical Informatics

    and then use a StructureMap to create Observations and Conditions for review/certification by a clinician? Or? BTW Love your posts Josh. Fun graphics, useful as well as provocative info!

    1 reaction