CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

generating-synthea-data

Generates synthetic but realistic patient records (FHIR R4 bundles, C-CDA documents, CSV) with MITRE Synthea for development, CI fixtures, demos, and leakage-gate test sets — zero real PHI. Use when you need safe, shareable test data for an OpenMed pipeline, reproducible fixtures for tests, or a held-out set for de-identification leakage gates, instead of touching real clinical data. Synthea output feeds the FHIR/C-CDA ingestion skills and openmed.eval. Trigger keywords: Synthea, synthetic data, fake patients, test fixtures, demo data, FHIR bundle generator, synthetic EHR, no PHI.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, information-dense body with genuinely executable quick-start commands and excellent edge-case coverage (determinism, version drift, licensing). Its main weaknesses are the absence of any validation checkpoint in the batch-generation workflow and a few unfinished details (placeholder output filename, malformed 'parsing-...' reference) that keep actionability and progressive disclosure at 4.

Suggestions

Add an explicit validation step to the workflow after generation — e.g. 'Verify output: check output/fhir/ contains the expected N bundles and spot-check one Bundle resourceType' — before committing fixtures; this lifts workflow clarity past the batch-operation cap.

Fix the unfinished hand-off reference 'Feed the FHIR bundles to `parsing-... ` skills' by naming the actual sibling skills (parsing-ccda-documents, fetching-fhir-resources) and replace the placeholder 'Patient_xyz.json' with a concrete glob example (e.g. output/fhir/*.json).

Trim the editorial framing ('a mountain of governance — and you shouldn't have to', 'which is exactly what makes it a great test bed') to tighten conciseness, and consider moving the module-selection and exporter-flag detail into a reference file if the skill grows.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious operational facts (seed pinning, exporter flags, version drift), but carries editorial framing that could be trimmed: 'a mountain of governance — and you shouldn't have to' and 'which is exactly what makes it a great test bed'. This fits the 'efficient; minor instances of over-explanation' anchor, not the 5 anchor where every token earns its place.

4 / 5

Actionability

Quick start gives copy-paste-ready commands ('git clone… ./gradlew build -x test', './run_synthea -s 12345 -p 20 --exporter.baseDirectory=./fixtures') and a runnable Python snippet, so it is above the 3 anchor. It falls short of 5 due to the placeholder 'output/fhir/Patient_xyz.json' path and the malformed hand-off reference 'parsing-... ` skills'.

4 / 5

Workflow Clarity

The six-step Workflow section is clearly sequenced (scale → formats → seed → modules → leakage-gate corpus → commit), but population generation is a batch operation with no validation checkpoint — no step verifies the generated output (file counts, FHIR bundle validity) before committing fixtures. Per the guidelines, missing validation in batch operations caps workflow clarity at 3; it is not a 2 because the sequence itself is well-defined.

3 / 5

Progressive Disclosure

No bundle files exist, so the single ~120-line SKILL.md is the whole skill; it is well-sectioned (When to use, Quick start, Workflow, Hand-off, Edge cases, References) with external links clearly grouped. It fits the 4 anchor: good structure with minor gaps — module-selection and exporter-flag detail would sit well in a reference file, and the broken 'parsing-...' inline reference hurts navigation slightly.

4 / 5

Total

15

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete capabilities in three output formats, an explicit 'Use when…' clause with three named scenarios, and a comprehensive natural-language trigger keyword list. The only deduction is the second-person 'you need' phrasing, which the guidelines penalize on specificity.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage — 'Generates synthetic but realistic patient records (FHIR R4 bundles, C-CDA documents, CSV)' for 'development, CI fixtures, demos, and leakage-gate test sets' — which matches the 5 anchor, but the second-person phrasing 'Use when you need safe, shareable test data' incurs the mandated 1-point specificity penalty.

4 / 5

Completeness

Explicitly answers both questions: what it does ('Generates synthetic but realistic patient records… zero real PHI') and when to use it ('Use when you need safe, shareable test data for an OpenMed pipeline, reproducible fixtures for tests, or a held-out set for de-identification leakage gates'). This is the 5 anchor verbatim in structure.

5 / 5

Trigger Term Quality

The explicit trigger list covers natural synonyms and colloquial phrasings users would actually say: 'Synthea, synthetic data, fake patients, test fixtures, demo data, FHIR bundle generator, synthetic EHR, no PHI'. This matches the comprehensive-coverage-with-synonyms anchor; no file extensions exist in this domain to include.

5 / 5

Distinctiveness Conflict Risk

A clear niche — synthetic patient-data generation via Synthea with 'zero real PHI' — with distinct triggers unlike any adjacent skill; 'Synthea output feeds the FHIR/C-CDA ingestion skills and openmed.eval' delineates the boundary rather than creating overlap.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

maziyarpanahi/openmed

Path

skills/generating-synthea-data/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.