# 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.

Author: map[bio:Rakenne Team name:Rakenne]
Published: 2026-02-18
Tags: Sanidad, Informes clínicos, CARE, HIPAA, Skills
URL: https://rakenne.app/es/learn/tutorials/clinical-reports-skill-guide/index.md


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:

1. **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.
2. **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).
3. **Informes de ensayos clínicos** — Clinical Study Reports (CSR) según ICH-E3; informes SAE; resúmenes tipo DSMB.
4. **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.


---

Back to [Tutoriales](https://rakenne.app/es/learn/tutorials/index.md)