foryourhealth111-pixel/Vibe-Skills / bundled/skills/clinical-reports
clinical-reports
VerifiedWrite comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP, H&P, discharge summaries). Full support with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation tools.
references/README.md
View on GitHub# Clinical Reports Skill
## Overview
Comprehensive skill for writing clinical reports including case reports, diagnostic reports, clinical trial reports, and patient documentation. Provides full support with templates, regulatory compliance, and validation tools.
## What's Included
### š Four Major Report Types
1. **Clinical Case Reports** - CARE-compliant case reports for medical journal publication
2. **Diagnostic Reports** - Radiology (ACR), pathology (CAP), and laboratory reports
3. **Clinical Trial Reports** - SAE reports, Clinical Study Reports (ICH-E3), DSMB reports
4. **Patient Documentation** - SOAP notes, H&P, discharge summaries, consultation notes
### š Reference Files (8 comprehensive guides)
- `case_report_guidelines.md` - CARE guidelines, de-identification, journal requirements
- `diagnostic_reports_standards.md` - ACR, CAP, CLSI standards, structured reporting systems
- `clinical_trial_reporting.md` - ICH-E3, CONSORT, SAE reporting, MedDRA coding
- `patient_documentation.md` - SOAP notes, H&P, discharge summary standards
- `regulatory_compliance.md` - HIPAA, 21 CFR Part 11, ICH-GCP, FDA regulations
- `medical_terminology.md` - SNOMED-CT, LOINC, ICD-10, CPT codes
- `data_presentation.md` - Clinical tables, figures, Kaplan-Meier curves
- `peer_review_standards.md` - Review criteria for clinical manuscripts
### š Templates (12 professional templates)
- `case_report_template.md` - Structured case report following CARE guidelines
- `soap_note_template.md` - SOAP progress note format
- `history_physical_template.md` - Complete H&P examination template
- `discharge_summary_template.md` - Hospital discharge documentation
- `consult_note_template.md` - Specialist consultation format
- `radiology_report_template.md` - Imaging report with structured reporting
- `pathology_report_template.md` - Surgical pathology with CAP synoptic elements
- `lab_report_template.md` - Clinical laboratory test results
- `clinical_trial_sae_template.md` - Serious adverse event report form
- `clinical_trial_csr_template.md` - Clinical study report outline (ICH-E3)
- `quality_checklist.md` - Quality assurance for all report types
- `hipaa_compliance_checklist.md` - Privacy and de-identification verification
### š§ Validation Scripts (8 automation tools)
- `validate_case_report.py` - Check CARE guideline compliance and completeness
- `check_deidentification.py` - Scan for 18 HIPAA identifiers in reports
- `validate_trial_report.py` - Verify ICH-E3 structure and required elements
- `format_adverse_events.py` - Generate AE summary tables from CSV data
- `generate_report_template.py` - Interactive template selection and generation
- `extract_clinical_data.py` - Parse and extract structured clinical data
- `compliance_checker.py` - Verify regulatory compliance requirements
- `terminology_validator.py` - Validate medical terminology and prohibited abbreviations
## Quick Start
### Generate a Template
```bash
cd .claude/skills/clinical-reports/scripts
python generate_report_template.py
# Or specify type directly
python generate_report_template.py --type case_report --output my_case_report.md
```
### Validate a Case Report
```bash
python validate_case_report.py my_case_report.md
```
### Check De-identification
```bash
python check_deidentification.py my_case_report.md
```
### Validate Clinical Trial Report
```bash
python validate_trial_report.py my_csr.md
```
## Key Features
### CARE Guidelines Compliance
- Complete CARE checklist coverage
- De-identification verification
- Informed consent documentation
- Timeline creation assistance
- Literature review integration
### Regulatory Compliance
- **HIPAA** - Privacy protection, 18 identifier removal, Safe Harbor method
- **FDA** - 21 CFR Parts 11, 50, 56, 312 compliance
- **ICH-GCP** - Good Clinical Practice standards
- **ALCOA-CCEA** - Data integrity principles
### Professional Standards
- **ACR** - American College of Radiology reporting standards
- **CAP** - College of American Pathologists synoptic reporting
- **CLSI** - Clinical Laboratory Standards Institute
- **CONSORT** - Clinical trial reporting
- **ICH-E3** - Clinical study report structure
### Medical Coding Systems
- **ICD-10-CM** - Diagnosis coding
- **CPT** - Procedure coding
- **SNOMED-CT** - Clinical terminology
- **LOINC** - Laboratory observation codes
- **MedDRA** - Medical dictionary for regulatory activities
## Common Use Cases
### 1. Publishing a Clinical Case Report
```
> Create a clinical case report for a 65-year-old patient with atypical
presentation of acute appendicitis
> Check this case report for HIPAA compliance
> Validate against CARE guidelines
```
### 2. Writing Diagnostic Reports
```
> Generate a radiology report template for chest CT
> Create a pathology report for colon resection specimen with adenocarcinoma
> Write a laboratory report for complete blood count
```
### 3. Clinical Trial Documentation
```
> Write a serious adverse event report for hospitalization due to pneumonia
> Create a clinical study report outline for phase 3 diabetes trial
> Generate adverse events summary table from trial data
```
### 4. Patient Clinical Notes
```
> Create a SOAP note for follow-up visit
> Generate an H&P for patient admitted with chest pain
> Write a discharge summary for heart failure hospitalization
> Create a cardiology consultation note
```
## Workflow Examples
### Case Report Workflow
1. **Obtain informed consent** from patient
2. **Generate template**: `python generate_report_template.py --type case_report`
3. **Write case report** following CARE structure
4. **Validate compliance**: `python validate_case_report.py case_report.md`
5. **Check de-identification**: `python check_deidentification.py case_report.md`
6. **Submit to journal** with CARE checklist
### Clinical Trial SAE Workflow
1. **Generate SAE template**: `python generate_report_template.py --type sae`
2. **Complete SAE form** within 24 hours of event
3. **Assess causality** using WHO-UMC or Naranjo criteria
4. **Validate completeness**: `python validate_trial_report.py sae_report.md`
5. **Submit to sponsor** within regulatory timelines (7 or 15 days)
6. **Notify IRB** per institutional policy
## Best Practices
### Privacy and Ethics
ā Always obtain informed consent for case reports
ā Remove all 18 HIPAA identifiers before publication
ā Use de-identification validation scripts
ā Document consent in manuscript
ā Consider re-identification risk for rare conditions
### Clinical Quality
ā Use professional medical terminology
ā Follow structured reporting templates
ā Include all required elements
ā Document chronology clearly
ā Support diagnoses with evidence
### Regulatory Compliance
ā Meet SAE reporting timelines (7-day, 15-day)
ā Follow ICH-E3 structure for CSRs
ā Maintain ALCOA-CCEA data integrity
ā Document protocol adherence
ā Use MedDRA coding for adverse events
### Documentation Standards
ā Sign and date all clinical notes
ā Document medical necessity
ā Use standard abbreviations only
ā Avoid prohibited abbreviations (JCAHO "Do Not Use" list)
ā Maintain legibility and completeness
## Integration
The clinical-reports skill integrates seamlessly with:
- **scientific-writing** - For clear, professional medical writing
- **peer-review** - For quality assessment of case reports
- **citation-management** - For literature references in case reports
- **research-grants** - For clinical trial protocol development
## Resources
### External Standards
- CARE Guidelines: https://www.care-statement.org/
- ICH-E3 Guideline: https://database.ich.org/sites/default/files/E3_Guideline.pdf
- CONSORT Statement: http://www.consort-statement.org/
- HIPAA: https://www.hhs.gov/hipaa/
- ACR Practice Parameters: https://www.acr.org/Clinical-Resources/Practice-Parameters-and-Technical-Standards
- CAP Cancer Protocols: https://www.cap.org/protocols-and-guidelines
### Professional Organizations
- American Medical Association (AMA)
- American College of Radiology (ACR)
- College of American Pathologists (CAP)
- Clinical Laboratory Standards Institute (CLSI)
- International Council for Harmonisation (ICH)
## Support
For issues or questions about the clinical-reports skill:
1. Check the comprehensive reference files
2. Review templates for examples
3. Run validation scripts to identify issues
4. Consult the SKILL.md for detailed guidance
## License
Part of the Claude Scientific Writer project. See main LICENSE file.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path ā even casually (like "the xlsx in my downloads") ā and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |