Agent skill
clinical-reports
Install this agent skill to your Project
npx add-skill https://github.com/drshailesh88/integrated_content_OS/tree/main/skills/cardiology/clinical-reports
SKILL.md
Clinical Reports
Professional clinical documentation covering case reports, diagnostic reports, trial reports, and patient documentation.
Triggers
- User needs to write a case report
- User is documenting clinical findings
- User wants to format trial results
- User needs diagnostic report structure
- User is preparing clinical documentation
Report Types
1. Case Reports (CARE Guidelines)
Required Sections:
| Section | Content |
|---|---|
| Title | Diagnosis and intervention focus |
| Abstract | Structured: background, case, conclusion |
| Introduction | Why this case matters |
| Patient Information | Demographics, history (de-identified) |
| Clinical Findings | Presentation, exam, initial assessment |
| Timeline | Chronological events |
| Diagnostic Assessment | Workup, reasoning, differentials |
| Therapeutic Intervention | Treatment details |
| Follow-up and Outcomes | Results, adherence, adverse events |
| Discussion | Context, rationale, limitations |
HIPAA De-identification (Remove 18 identifiers):
- Names, geographic data, dates (except year)
- Phone, fax, email, SSN, MRN
- Health plan numbers, account numbers
- License/vehicle numbers, device IDs
- URLs, IP addresses, biometrics, photos
2. Diagnostic Reports
Cardiology-Specific
Echocardiography Report Structure:
- Patient demographics
- Indication
- Technical quality
- LV size and function (EF method specified)
- RV assessment
- Valvular assessment (stenosis/regurgitation grading)
- Other findings
- Comparison with prior
- Impression and recommendations
Cardiac Catheterization Report:
- Procedure indication
- Access and technique
- Hemodynamics (pressures, gradients)
- Coronary anatomy (dominance, lesions)
- LV function
- Intervention performed (if any)
- Complications
- Recommendations
Electrophysiology Report:
- Indication
- Baseline intervals
- Findings (inducibility, mechanism)
- Ablation details (if performed)
- Outcomes and endpoints
- Recommendations
3. Clinical Trial Reports
Serious Adverse Event (SAE) Reports
Timeline Requirements:
- Fatal/life-threatening: 7 days
- Other serious: 15 days
Required Elements:
- Event description and onset date
- Seriousness criteria met
- Causality assessment
- Action taken with study drug
- Outcome
- Relevant medical history
- Concomitant medications
Clinical Study Report (ICH-E3 Structure)
- Title page
- Synopsis
- Table of contents
- List of abbreviations
- Ethics
- Investigators and study sites
- Introduction
- Study objectives
- Investigational plan
- Study patients
- Efficacy evaluation
- Safety evaluation
- Discussion and conclusions
- Tables, figures, graphs
- Reference list
- Appendices
4. Patient Documentation
SOAP Note Format
S (Subjective): Patient's reported symptoms, history
O (Objective): Vital signs, exam findings, test results
A (Assessment): Diagnosis, clinical reasoning
P (Plan): Treatment, follow-up, patient education
History & Physical Structure
- Chief complaint
- History of present illness
- Past medical/surgical history
- Medications and allergies
- Family history
- Social history
- Review of systems
- Physical examination
- Assessment and plan
Discharge Summary Elements
- Admission diagnosis
- Hospital course
- Procedures performed
- Discharge diagnosis
- Discharge medications (with changes noted)
- Follow-up appointments
- Patient education provided
- Contingency instructions
Compliance Requirements
Regulatory Standards
| Regulation | Applies To | Key Requirements |
|---|---|---|
| HIPAA | All US healthcare | Privacy, minimum necessary |
| 21 CFR Part 11 | Electronic records | Audit trails, signatures |
| ICH-GCP | Clinical trials | Protocol adherence, consent |
| FDA 21 CFR 312 | INDs | Safety reporting |
Standardized Terminology
- SNOMED CT: Clinical terms
- LOINC: Laboratory tests
- ICD-10-CM: Diagnoses
- CPT: Procedures
- RxNorm: Medications
Prohibited Abbreviations (Joint Commission)
| Don't Use | Problem | Use Instead |
|---|---|---|
| U | Mistaken for 0 | "unit" |
| IU | Mistaken for IV | "international unit" |
| QD, QOD | Confused | "daily," "every other day" |
| Trailing zero (1.0) | Decimal missed | 1 mg |
| No leading zero (.5) | Decimal missed | 0.5 mg |
| MS, MSO4, MgSO4 | Confused | "morphine" or "magnesium" |
Quality Standards
Documentation Must Be
- Complete: All relevant information included
- Accurate: Facts verified, no assumptions
- Timely: Documented promptly
- Clear: Understandable to readers
- Compliant: Meets regulatory requirements
Common Deficiencies to Avoid
- Missing dates/times
- Illegible entries (if handwritten)
- Use of prohibited abbreviations
- Incomplete medication reconciliation
- Missing informed consent documentation
- Inadequate follow-up instructions
Cardiology Case Report Considerations
What Makes a Publishable Case
- Novel presentation of known disease
- Unexpected treatment response
- Diagnostic challenge with learning points
- Rare condition with management insights
- Adverse event with safety implications
Key Cardiovascular Data to Include
- ECG findings (with images if relevant)
- Imaging results (echo, angiography, CT/MRI)
- Biomarkers (troponin, BNP trends)
- Hemodynamic data
- Procedural details and outcomes
- Long-term follow-up
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
pufferlib
This skill should be used when working with reinforcement learning tasks including high-performance RL training, custom environment development, vectorized parallel simulation, multi-agent systems, or integration with existing RL environments (Gymnasium, PettingZoo, Atari, Procgen, etc.). Use this skill for implementing PPO training, creating PufferEnv environments, optimizing RL performance, or developing policies with CNNs/LSTMs.
fluidsim
Framework for computational fluid dynamics simulations using Python. Use when running fluid dynamics simulations including Navier-Stokes equations (2D/3D), shallow water equations, stratified flows, or when analyzing turbulence, vortex dynamics, or geophysical flows. Provides pseudospectral methods with FFT, HPC support, and comprehensive output analysis.
metabolomics-workbench-database
Access NIH Metabolomics Workbench via REST API (4,200+ studies). Query metabolites, RefMet nomenclature, MS/NMR data, m/z searches, study metadata, for metabolomics and biomarker discovery.
geniml
This skill should be used when working with genomic interval data (BED files) for machine learning tasks. Use for training region embeddings (Region2Vec, BEDspace), single-cell ATAC-seq analysis (scEmbed), building consensus peaks (universes), or any ML-based analysis of genomic regions. Applies to BED file collections, scATAC-seq data, chromatin accessibility datasets, and region-based genomic feature learning.
zinc-database
Access ZINC (230M+ purchasable compounds). Search by ZINC ID/SMILES, similarity searches, 3D-ready structures for docking, analog discovery, for virtual screening and drug discovery.
astropy
Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordinate systems (WCS), and astronomical data analysis. Use when tasks involve coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions, or astronomical data processing.
Didn't find tool you were looking for?