Skip to content

K-Dense-AI/scientific-agent-skills / skills/clinical-reports

clinical-reports

Verified

Creates safety-bounded draft structures and runs local deterministic checks for clinical case, diagnostic, trial, safety, and aggregate research reports. Use only with synthetic, de-identified, or aggregate inputs and verified source-fact manifests; every output requires qualified review.

FileKindSize
SKILL.mdskill md15.5 KB
assets/adverse_event_aggregate_input_template.csvother120 B
assets/case_report_template.jsonconfig2.1 KB
assets/clinical_trial_csr_template.jsonconfig2.6 KB
assets/clinical_trial_results_template.jsonconfig3.8 KB
assets/clinical_trial_safety_aggregate_template.jsonconfig1.4 KB
assets/consistency_manifest_template.jsonconfig531 B
assets/deidentification_process_checklist.jsonconfig2.1 KB
assets/lab_report_template.jsonconfig1.7 KB
assets/pathology_report_template.jsonconfig1.7 KB
assets/provenance_manifest_template.jsonconfig560 B
assets/quality_review_checklist.jsonconfig1.7 KB
assets/radiology_report_template.jsonconfig1.5 KB
assets/research_summary_template.jsonconfig1.6 KB
assets/terminology_manifest_template.jsonconfig426 B
assets/trial_protocol_reporting_checklist.jsonconfig4.2 KB
references/README.mdmarkdown2.2 KB
references/case_report_guidelines.mdmarkdown3.3 KB
references/clinical_trial_reporting.mdmarkdown5.3 KB
references/data_presentation.mdmarkdown4.1 KB
references/diagnostic_reports_standards.mdmarkdown4.3 KB
references/medical_terminology.mdmarkdown4.2 KB
references/privacy_and_deidentification.mdmarkdown4.8 KB
references/professional_review.mdmarkdown4.2 KB
references/report_type_routing.mdmarkdown4.4 KB
references/safety_reporting.mdmarkdown6.8 KB
references/sources.mdmarkdown10.8 KB
scripts/_common.pyscript9.5 KB
scripts/check_deidentification.pyscript10.7 KB
scripts/consistency_checker.pyscript13.4 KB
scripts/format_adverse_events.pyscript16.0 KB
scripts/generate_report_template.pyscript3.9 KB
scripts/provenance_validator.pyscript9.2 KB
scripts/terminology_validator.pyscript10.0 KB
scripts/validate_case_report.pyscript9.4 KB
scripts/validate_trial_report.pyscript19.9 KB

references/medical_terminology.md

View on GitHub
# Versioned Terminology and Schema Checks

Terminology selection and coding are clinical/regulatory tasks. The local checker validates manifest shape and code syntax; it does not confirm that a code exists, is current, matches a display, or is clinically appropriate.

## Required manifest fields

For every coded item record:

- `system`: controlled system name;
- `system_uri`: canonical identifier supplied by the implementing organization;
- `code`;
- `display`;
- `version`;
- `language`;
- `source_fact_id`;
- `coding_status`: `verified_by_qualified_reviewer` or `unverified`;
- `verified_by_role` and `verified_at` when verified.

Do not infer a code from narrative text.

## MedDRA

- ICH developed MedDRA for regulatory information about human medical products.
- The current released English guide is MedDRA 29.1, September 2026; a release date is not a universal study or regulatory implementation date.
- MedDRA uses a multiaxial hierarchy and version-specific currency/relationships.
- State exact version and language.
- Use the study/sponsor-authorized version, official licensed files, and current Points to Consider.
- Do not assume the newest release is the required release.

The aggregate adverse-event formatter accepts SOC and PT labels as supplied and does not validate hierarchy, codes, or coding quality.

## LOINC

LOINC identifies health observations, measurements, and documents. LOINC 2.83 was released 19 August 2026 and is the current release at this review. Planned monthly releases are a future cadence change; verify actual release files before selecting a version.

- A valid-looking `number-checkdigit` string is only syntactic evidence.
- The method, property, timing, system/specimen, scale, and version can affect meaning.
- Verify against the official release or authorized terminology service.
- Review the LOINC license and third-party content terms.

## SNOMED CT

SNOMED CT concept identifiers are not clinically validated by their numeric shape.

- Use the applicable international edition, national extension, and effective date.
- Verify concept activity, module, description, and reference-set membership.
- Comply with SNOMED International and national licensing/distribution requirements.
- Do not embed or redistribute licensed terminology content through these assets.

## ICD-10-CM

ICD-10-CM changes by fiscal-year release and may require encounter, laterality, or placeholder characters.

- Record the exact release, applicable jurisdiction, and service-date range. CDC lists FY27 files for services from 1 October 2026; on this review date (30 September 2026), the FY26 April update still applies to services in its stated date window. File availability does not make a future effective version applicable early.
- Verify with official CDC/CMS files and coding guidance.
- A regex match cannot establish billability, specificity, sequencing, or clinical correctness.
- This skill does not support billing or reimbursement decisions.

## UCUM and units

Record the original unit exactly and, when an organization uses UCUM, record the verified UCUM expression separately. Do not automatically convert units in a report draft.

Any conversion must have:

- an authorized rule and version;
- original value/unit;
- converted value/unit;
- precision/rounding rule;
- source-fact and reviewer traceability.

The consistency checker flags missing or inconsistent unit labels but performs no clinical conversion. The terminology checker uses a restricted character screen for UCUM, not the complete UCUM grammar or semantic parser. Do not change a verified expression merely to satisfy that screen; record the limitation for qualified review.

## Optional local dictionary

`terminology_validator.py --dictionary <file.json>` can compare code/display/version tuples with a caller-supplied local dictionary. The dictionary must be an authorized bounded JSON file.

A match means only “matched this supplied dictionary.” It does not prove:

- the dictionary is official, complete, current, or licensed for the use;
- the chosen code is appropriate;
- the clinical statement is true;
- the report is compliant or ready for release.

Without a dictionary, the strongest result is `SCHEMA_VALID_SYNTAX_ONLY_REVIEW_REQUIRED`.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall