Guía completa de la skill Clinical Report Writing
Guía detallada de la skill Clinical Report Writing: qué incluye, cómo usarla, estructura de archivos que crea, referencias que usa y comprobaciones de validación que ejecuta.
La skill Clinical Report Writing ayuda a redactar y validar documentación clínica: informes de casos (guías CARE), informes diagnósticos (radiología, patología, laboratorio), informes de ensayos clínicos (ICH-E3, SAE, CSR) y documentación de paciente (notas SOAP, H&P, resúmenes de alta). Esta guía explica qué cubre la skill, cómo usarla, qué estructura y plantillas proporciona, qué referencias utiliza y qué comprobaciones ejecutan las herramientas integradas.
Qué incluye la skill
La skill guía cuatro categorías principales de informes clínicos:
- Informes de casos clínicos para publicación — Guías CARE: título, palabras clave, resumen, introducción, información del paciente, hallazgos clínicos, cronología, evaluación diagnóstica, intervenciones terapéuticas, seguimiento, discusión y consentimiento informado.
- Informes diagnósticos — Estructura de informes de radiología, patología y laboratorio con secciones estándar (indicación clínica, técnica, comparación, hallazgos, impresión).
- Informes de ensayos clínicos — Clinical Study Reports (CSR) según ICH-E3; informes SAE; resúmenes tipo DSMB.
- Documentación de paciente — Notas SOAP, historia y exploración física (H&P), resumen de alta, notas de consulta.
También aplica normativa y buenas prácticas: desidentificación HIPAA (18 identificadores), consentimiento informado, abreviaturas “Do Not Use” de JCAHO y ambiguas, y uso opcional de la skill scientific-schematics para al menos una figura por informe (p. ej. cronología, diagrama CONSORT).
Qué puedes solicitar
| Objetivo | Ejemplos de prompt |
|---|---|
| Redactar informe de caso | “Redacta un informe de caso clínico para envío a revista siguiendo las guías CARE. He añadido mis notas y la cronología del paciente (desidentificada).” |
| Crear informe diagnóstico | “Crea un informe de radiología (o patología/laboratorio) a partir de los hallazgos que he pegado.” |
| Documentación de paciente | “Escribe una nota SOAP (o resumen de alta, H&P) para esta consulta.” |
| Informes de ensayo | “Redacta el esquema de un Clinical Study Report según ICH-E3” o “Formatea esta CSV de eventos adversos en una tabla resumen de EA.” |
| Validar CARE | “Valida mi informe de caso frente a las guías CARE.” |
| Comprobar desidentificación | “Ejecuta el comprobador de desidentificación en este informe antes de enviarlo.” |
| Comprobar terminología | “Comprueba abreviaturas prohibidas o ambiguas.” |
| Comprobar cumplimiento normativo | “Comprueba los indicadores HIPAA/GCP/FDA en este documento.” |
Añade tus materiales fuente (notas, cronologías, valores de laboratorio, CSV) al espacio de trabajo del proyecto y activa la skill Clinical Report Writing; el agente te guiará paso a paso.
Estructura de archivos creada
La skill no impone una estructura de carpetas fija. Proporciona plantillas (en los assets/ de la skill) que el agente puede copiar y rellenar:
Informes de caso y de ensayo
| Plantilla | Propósito |
|---|---|
case_report_template.md | Informe de caso estructurado según CARE. |
clinical_trial_csr_template.md | Estructura ICH-E3 de CSR. |
clinical_trial_sae_template.md | Informe de evento adverso grave. |
Documentación de paciente
| Plantilla | Propósito |
|---|---|
soap_note_template.md | Nota SOAP. |
history_physical_template.md | Historia y exploración física. |
discharge_summary_template.md | Resumen de alta. |
consult_note_template.md | Nota de consulta. |
Informes diagnósticos
| Plantilla | Propósito |
|---|---|
radiology_report_template.md | Informe de radiología. |
pathology_report_template.md | Informe de patología. |
lab_report_template.md | Informe de laboratorio. |
Listas de comprobación
| Recurso | Propósito |
|---|---|
quality_checklist.md | Lista de calidad y completitud. |
hipaa_compliance_checklist.md | Lista de desidentificación HIPAA y consentimiento. |
Qué se usa como referencia
La skill carga las siguientes referencias desde su directorio references/:
| Archivo de referencia | Contenido |
|---|---|
case_report_guidelines.md | Lista CARE para informes de caso. |
clinical_trial_reporting.md | ICH-E3 y estructura CSR/SAE/DSMB. |
diagnostic_reports_standards.md | Estándares para informes de radiología, patología y laboratorio. |
patient_documentation.md | Convenciones SOAP, H&P, alta, consulta. |
data_presentation.md | Tablas, figuras y presentación de datos. |
medical_terminology.md | Terminología, abreviaturas y códigos (p. ej. ICD-10). |
peer_review_standards.md | Revisión por pares y requisitos de revistas. |
regulatory_compliance.md | HIPAA, FDA, ICH-GCP (consentimiento, desidentificación, notificación de seguridad). |
Se referencian conceptualmente CARE, ICH E6(R3) GCP, ICH E3 (CSR), HIPAA (18 identificadores), lista “Do Not Use” de JCAHO, FDA.
Qué comprobaciones se realizan
La skill incluye una extensión con siete herramientas:
1. validate_case_report
Valida informes de caso frente a CARE: secciones requeridas, comprobación rápida HIPAA, número de palabras, referencias. Salida: PASS/NEEDS_REVISION, lista CARE, advertencias HIPAA.
2. validate_trial_report
Valida CSR frente a secciones ICH-E3 (portada, sinopsis, índice, abreviaturas, ética, investigadores, introducción, objetivos, pacientes, eficacia, seguridad, discusión, tablas/figuras, referencias, anexos). Salida: porcentaje de cumplimiento y lista de secciones.
3. check_deidentification
Busca los 18 identificadores HIPAA (nombres, datos geográficos, fechas, teléfono, email, SSN, MRN, etc.) y reporta gravedad (CRITICAL/HIGH/MEDIUM) y ejemplos. Comprueba edad >89 (agregar como “90 o más”). Salida: COMPLIANT / NEEDS_REVIEW / NON_COMPLIANT.
4. validate_terminology
Comprueba JCAHO Do Not Use (U, IU, QD, QOD, MS, MSO4, MgSO4) con reemplazos sugeridos, abreviaturas ambiguas (cc, hs, TIW, SC, D/C, OS, OD, OU, etc.) y códigos ICD-10.
5. check_compliance
Comprueba indicadores de HIPAA (consentimiento, desidentificación), GCP (IRB/IEC, protocolo, consentimiento), FDA (IND/IDE/protocolo, eventos adversos/SAE). Salida: OK/MISSING por comprobación.
6. extract_clinical_data
Extrae datos estructurados: demografía, constantes (temp, TA, FC, FR, SpO2), medicación (principio, dosis, vía, frecuencia). Salida: JSON.
7. format_adverse_events
Convierte un CSV con columnas treatment_arm, any_ae, related, serious, fatal, discontinuation en una tabla resumen en Markdown por brazo de tratamiento.
Cuándo ejecutar qué: Tras redactar un informe de caso, validate_case_report y check_deidentification; para CSR, validate_trial_report. Antes de cerrar un documento, validate_terminology y check_compliance. Usar extract_clinical_data y format_adverse_events cuando hagan falta datos estructurados o tablas de EA.
Resumen
| Tema | Resumen |
|---|---|
| Contenido de la skill | Cuatro categorías: informes de caso (CARE), diagnósticos, de ensayo (ICH-E3, SAE, CSR), documentación de paciente. Más HIPAA, terminología y opcional scientific-schematics. |
| Prompts | Redactar informes; validar CARE/ICH-E3; comprobar desidentificación, terminología, cumplimiento; formatear CSV de EA; extraer datos clínicos. |
| Estructura | Plantillas para informe de caso, CSR, SAE, SOAP, H&P, alta, consulta, radiología, patología, laboratorio y listas de comprobación. |
| Referencias | Ocho archivos de referencia (CARE, ICH E3/E6, HIPAA, JCAHO, FDA). |
| Comprobaciones | Siete herramientas: validate_case_report, validate_trial_report, check_deidentification, validate_terminology, check_compliance, extract_clinical_data, format_adverse_events. |
Usa la skill Clinical Report Writing cuando necesites redactar o validar documentación clínica y quieras que el agente siga CARE, ICH-E3 e HIPAA con plantillas, referencias y herramientas de validación en un solo lugar.