render-questionnaire

Stars0

Forks0

UpdatedJuly 7, 2026 at 08:56

Render a generated FHIR Questionnaire JSON as a dependency-free, offline HTML preview for review. Resolves answerValueSet via the CodeSystems in fsh-generated, shows each item with its answer options, the ordinalValue scoring weights (badges), and German translations (translation extension). Use when you want to SEE/review a questionnaire form without the IG Publisher (no Jekyll) or LHC-Forms (no CDN) — e.g. reviewing PHQ-9/PHQ-15/WHODAS/PROMIS questionnaires. Triggers: 'render the questionnaire', 'preview the form', 'show me the questionnaire to review'.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

medizininformatik-initiative

medizininformatik-initiative/kerndatensatzmodul-proms

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Web DevelopersComputer and Mathematical Occupations·SOC 15-1254

File Explorer

2 files

SKILL.md

readonly

name

render-questionnaire

description

render-questionnaire

Produces a self-contained HTML preview of a FHIR R4 Questionnaire so it can be reviewed visually, without external dependencies (no IG Publisher/Jekyll, no LHC-Forms CDN).

What it shows

Groups → sections, display items → stems, choice items → questions with their answer options.
answerValueSet is resolved against the CodeSystems found in the same fsh-generated/resources folder, so options appear even when not inline.
ordinalValue weight badges per option (read from the answerOption extension OR the CodeSystem concept ordinalValue/itemWeight property) — a missing weight is flagged red.
German translations (the hl7-translation extension) shown under each EN-primary text.

Usage

python3 .claude/skills/render-questionnaire/render_questionnaire.py \
  fsh-generated/resources/Questionnaire-mii-qst-pro-phq-15.json \
  --title "PHQ-15 (Review)" --open

First arg: path (or glob) to the generated Questionnaire JSON.
--out <file>: output HTML path (default: /tmp/-preview.html).
--title "...": heading. --note "...": yellow note box (e.g. licensing).
--open: open the HTML in the default browser (macOS open).

Terminology (CodeSystem/ValueSet) is auto-loaded from the Questionnaire JSON's directory.

Notes

This is a review tool, not a form filler — it does not evaluate calculatedExpression (no live scoring). Weight badges reflect the declared ordinalValue, so reviewers can check the scoring weights without a runtime engine.
For interactive filling/live scoring use the project's actual SDC renderer (gefyra/ISiK) or the IG Publisher build.

More from this repository

same repository

author-pro-questionnaire

medizininformatik-initiative/kerndatensatzmodul-proms

Author a new PRO instrument (FHIR Questionnaire + score ObservationDefinition + example) in the MII PRO module, following the repo's settled conventions: naming, canonical item-bank linkIds, answerValueSet + ordinalValue-on-CodeSystem answer modelling, EN-primary + DE-translation, scoring (FHIRPath .ordinal() vs CQL), licensing tiers, and subset/derivedFrom for abbreviated instruments. Use when adding/refactoring a questionnaire instrument (PHQ, GAD, WHODAS, PROMIS, EORTC, etc.). Triggers: 'add a questionnaire', 'implement instrument X', 'build a PRO questionnaire', 'how do we model the answers/scoring/items'.

2026-07-070

extract-qst-translations

medizininformatik-initiative/kerndatensatzmodul-proms

Extract item texts, answer labels and language translations from generated FHIR Questionnaire JSON files. Outputs TSV/CSV for systematic comparison against external source PDFs (e.g. PROMIS Profile 33 deutsch). Use when validating translation quality, finding LOINC-vs-validated-translation drift, auditing primary-language consistency, or preparing diff tables for reviewers.

2026-06-100

fix-ig-export-links

medizininformatik-initiative/kerndatensatzmodul-proms

Generate and run scripts to fix broken Simplifier resolve links in MII Implementation Guide exports. This skill reads module configuration and generates a customized fix script for each MII KDS module. Use when downloading an IG from Simplifier and links are broken, preparing an IG export for offline use, or making links work both locally and on official MII pages.

2026-01-120

name

render-questionnaire

description

render-questionnaire

Produces a self-contained HTML preview of a FHIR R4 Questionnaire so it can be reviewed visually, without external dependencies (no IG Publisher/Jekyll, no LHC-Forms CDN).

What it shows

Groups → sections, display items → stems, choice items → questions with their answer options.
answerValueSet is resolved against the CodeSystems found in the same fsh-generated/resources folder, so options appear even when not inline.
ordinalValue weight badges per option (read from the answerOption extension OR the CodeSystem concept ordinalValue/itemWeight property) — a missing weight is flagged red.
German translations (the hl7-translation extension) shown under each EN-primary text.

Usage

python3 .claude/skills/render-questionnaire/render_questionnaire.py \
  fsh-generated/resources/Questionnaire-mii-qst-pro-phq-15.json \
  --title "PHQ-15 (Review)" --open

First arg: path (or glob) to the generated Questionnaire JSON.
--out <file>: output HTML path (default: /tmp/-preview.html).
--title "...": heading. --note "...": yellow note box (e.g. licensing).
--open: open the HTML in the default browser (macOS open).

Terminology (CodeSystem/ValueSet) is auto-loaded from the Questionnaire JSON's directory.

Notes

This is a review tool, not a form filler — it does not evaluate calculatedExpression (no live scoring). Weight badges reflect the declared ordinalValue, so reviewers can check the scoring weights without a runtime engine.
For interactive filling/live scoring use the project's actual SDC renderer (gefyra/ISiK) or the IG Publisher build.