trial-metadata-extractor

Extract structured metadata from clinical trial Protocol and SAP documents into JSON.

35|9|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/Appsilon/mediforce --skill trial-metadata-extractor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trial-metadata-extractor
Source: https://github.com/Appsilon/mediforce/tree/main/apps/protocol-to-tfl/plugins/protocol-to-tfl/skills/trial-metadata-extractor
Command: npx skills add https://github.com/Appsilon/mediforce --skill trial-metadata-extractor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extracts structured metadata from clinical trial Protocol and SAP documents into a standardized JSON format that can be used to plan ADaM datasets and generate mock TLG shells downstream.

Core Features & Use Cases

  • Protocol and SAP parsing: Reads Protocol and/or SAP and produces a comprehensive trial metadata JSON contract that downstream tools can consume.
  • Cross-document validation: Compares Protocol and SAP elements for consistency and flags discrepancies.
  • Downstream readiness: Outputs a contract-like JSON that can be fed into a mock TLG generator for shell creation.
  • Use Case: Given a Protocol and an SAP, extract study design, endpoints, populations, visit schedules, and analysis plans into a single structured JSON for review.

Quick Start

Provide one or both documents (Protocol and/or SAP) or their file paths to trigger a structured extraction and receive a JSON metadata file.

Frequently Asked Questions about trial-metadata-extractor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract clinical trial metadata from Protocol and SAP documents?

To extract clinical trial metadata, provide the Skill with your Protocol and SAP documents via file paths or uploads. It parses study design, endpoints, populations, visit schedules, and analysis plans, then outputs a standardized JSON contract for downstream consumption.

What is the JSON output format used for clinical trial metadata extraction?

The JSON output format serves as a contract-like structure capturing study design, endpoints, populations, visit schedules, and analysis plans from your Protocol and SAP. This standardized JSON can be directly consumed by downstream tools to plan ADaM datasets and generate mock TLG shells.

Can I extract trial metadata from a Protocol without an SAP document?

Yes, you can extract trial metadata from a Protocol without an SAP, or vice versa. The Skill processes either document independently to capture study design and endpoints, but providing both enables cross-document validation to flag discrepancies between Protocol and SAP elements.

How do Protocol and SAP cross-document validation discrepancies get flagged?

Discrepancies are flagged by comparing Protocol and SAP elements for consistency during extraction. The Skill identifies mismatches between study design, endpoints, or analysis plans across both documents and surfaces them in the structured JSON output for your review.

Does the extracted trial metadata JSON work for generating mock TLG shells?

Yes, the extracted trial metadata JSON is designed for downstream readiness and works for generating mock TLG shells. The contract-like JSON output can be fed directly into a mock TLG generator to plan ADaM datasets and create shell tables, listings, and graphs.

What are the limitations when extracting clinical trial metadata from Protocol and SAP files?

Limitations include reliance on the quality and completeness of your Protocol and SAP source files. The extraction preserves fidelity to source documents and flags discrepancies but does not resolve them, and the JSON output requires downstream tools to generate final mock TLGs.