clinical-reports
Automates medical documentation and clinical report generation while ensuring regulatory compliance.
Install
mkdir -p .claude/skills/clinical-reports && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2089" && unzip -o skill.zip -d .claude/skills/clinical-reports && rm skill.zipInstalls to .claude/skills/clinical-reports
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Write 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.Key capabilities
- →Generates templates for clinical research reports
- →Formats documentation to CARE or ICH-E3 standards
- →Integrates mandatory scientific schematics via API
- →Validates HIPAA and regulatory compliance
How it works
Applies a constraint-based writing framework to data input, forcing adherence to professional healthcare reporting guidelines.
Inputs & outputs
When to use clinical-reports
- →Drafting SOAP notes
- →Preparing clinical study reports
- →Writing radiology diagnostic summaries
- →Generating discharge documentation
About this skill
Clinical Report Writing
Overview
Clinical report writing is the process of documenting medical information with precision, accuracy, and compliance with regulatory standards. This skill covers four major categories of clinical reports: case reports for journal publication, diagnostic reports for clinical practice, clinical trial reports for regulatory submission, and patient documentation for medical records. Apply this skill for healthcare documentation, research dissemination, and regulatory compliance.
Critical Principle: Clinical reports must be accurate, complete, objective, and compliant with applicable regulations (HIPAA, FDA, ICH-GCP). Patient privacy and data integrity are paramount. All clinical documentation must support evidence-based decision-making and meet professional standards.
When to Use This Skill
This skill should be used when:
- Writing clinical case reports for journal submission (CARE guidelines)
- Creating diagnostic reports (radiology, pathology, laboratory)
- Documenting clinical trial data and adverse events
- Preparing clinical study reports (CSR) for regulatory submission
- Writing patient progress notes, SOAP notes, and clinical summaries
- Drafting discharge summaries, H&P documents, or consultation notes
- Ensuring HIPAA compliance and proper de-identification
- Validating clinical documentation for completeness and accuracy
- Preparing serious adverse event (SAE) reports
- Creating data safety monitoring board (DSMB) reports
Visual Enhancement with Scientific Schematics
⚠️ MANDATORY: Every clinical report MUST include at least 1 AI-generated figure using the scientific-schematics skill.
This is not optional. Clinical reports benefit greatly from visual elements. Before finalizing any document:
- Generate at minimum ONE schematic or diagram (e.g., patient timeline, diagnostic algorithm, or treatment workflow)
- For case reports: include clinical progression timeline
- For trial reports: include CONSORT flow diagram
How to generate figures:
- Use the scientific-schematics skill to generate AI-powered publication-quality diagrams
- Simply describe your desired diagram in natural language
- Nano Banana Pro will automatically generate, review, and refine the schematic
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
The AI will automatically:
- Create publication-quality images with proper formatting
- Review and refine through multiple iterations
- Ensure accessibility (colorblind-friendly, high contrast)
- Save outputs in the figures/ directory
When to add schematics:
- Patient case timelines and clinical progression diagrams
- Diagnostic algorithm flowcharts
- Treatment protocol workflows
- Anatomical diagrams for case reports
- Clinical trial participant flow diagrams (CONSORT)
- Adverse event classification trees
- Any complex concept that benefits from visualization
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Core Capabilities
1. Clinical Case Reports for Journal Publication
Clinical case reports describe unusual clinical presentations, novel diagnoses, or rare complications. They contribute to medical knowledge and are published in peer-reviewed journals.
CARE Guidelines Compliance
The CARE (CAse REport) guidelines provide a standardized framework for case report writing. All case reports should follow this checklist:
Title
- Include the words "case report" or "case study"
- Indicate the area of focus
- Example: "Unusual Presentation of Acute Myocardial Infarction in a Young Patient: A Case Report"
Keywords
- 2-5 keywords for indexing and searchability
- Use MeSH (Medical Subject Headings) terms when possible
Abstract (structured or unstructured, 150-250 words)
- Introduction: What is unique or novel about the case?
- Patient concerns: Primary symptoms and key medical history
- Diagnoses: Primary and secondary diagnoses
- Interventions: Key treatments and procedures
- Outcomes: Clinical outcome and follow-up
- Conclusions: Main takeaway or clinical lesson
Introduction
- Brief background on the medical condition
- Why this case is novel or important
- Literature review of similar cases (brief)
- What makes this case worth reporting
Patient Information
- Demographics (age, sex, race/ethnicity if relevant)
- Medical history, family history, social history
- Relevant comorbidities
- De-identification: Remove or alter 18 HIPAA identifiers
- Patient consent: Document informed consent for publication
Clinical Findings
- Chief complaint and presenting symptoms
- Physical examination findings
- Timeline of symptoms (consider timeline figure or table)
- Relevant clinical observations
Timeline
- Chronological summary of key events
- Dates of symptoms, diagnosis, interventions, outcomes
- Can be presented as a table or figure
- Example format:
- Day 0: Initial presentation with symptoms X, Y, Z
- Day 2: Diagnostic test A performed, revealed finding B
- Day 5: Treatment initiated with drug C
- Day 14: Clinical improvement noted
- Month 3: Follow-up examination shows complete resolution
Diagnostic Assessment
- Diagnostic tests performed (labs, imaging, procedures)
- Results and interpretation
- Differential diagnosis considered
- Rationale for final diagnosis
- Challenges in diagnosis
Therapeutic Interventions
- Medications (names, dosages, routes, duration)
- Procedures or surgeries performed
- Non-pharmacological interventions
- Reasoning for treatment choices
- Alternative treatments considered
Follow-up and Outcomes
- Clinical outcome (resolution, improvement, unchanged, worsened)
- Follow-up duration and frequency
- Long-term outcomes if available
- Patient-reported outcomes
- Adherence to treatment
Discussion
- Strengths and novelty of the case
- How this case compares to existing literature
- Limitations of the case report
- Potential mechanisms or explanations
- Clinical implications and lessons learned
- Unanswered questions or areas for future research
Patient Perspective (optional but encouraged)
- Patient's experience and viewpoint
- Impact on quality of life
- Patient-reported outcomes
- Quote from patient if appropriate
Informed Consent
- Statement documenting patient consent for publication
- If patient deceased or unable to consent, describe proxy consent
- For pediatric cases, parental/guardian consent
- Example: "Written informed consent was obtained from the patient for publication of this case report and accompanying images. A copy of the written consent is available for review by the Editor-in-Chief of this journal."
For detailed CARE guidelines, refer to references/case_report_guidelines.md.
Journal-Specific Requirements
Different journals have specific formatting requirements:
- Word count limits (typically 1500-3000 words)
- Number of figures/tables allowed
- Reference style (AMA, Vancouver, APA)
- Structured vs. unstructured abstract
- Supplementary materials policies
Check journal instructions for authors before submission.
De-identification and Privacy
18 HIPAA Identifiers to Remove or Alter:
- Names
- Geographic subdivisions smaller than state
- Dates (except year)
- Telephone numbers
- Fax numbers
- Email addresses
- Social Security numbers
- Medical record numbers
- Health plan beneficiary numbers
- Account numbers
- Certificate/license numbers
- Vehicle identifiers and serial numbers
- Device identifiers and serial numbers
- Web URLs
- IP addresses
- Biometric identifiers
- Full-face photographs
- Any other unique identifying characteristic
Best Practices:
- Use "the patient" instead of names
- Report age ranges (e.g., "a woman in her 60s") or exact age if relevant
- Use approximate dates or time intervals (e.g., "3 months prior")
- Remove institution names unless necessary
- Blur or crop identifying features in images
- Obtain explicit consent for any potentially identifying information
2. Clinical Diagnostic Reports
Diagnostic reports communicate findings from imaging studies, pathological examinations, and laboratory tests. They must be clear, accurate, and actionable.
Radiology Reports
Radiology reports follow a standardized structure to ensure clarity and completeness.
Standard Structure:
1. Patient Demographics
- Patient name (or ID in research contexts)
- Date of birth or age
- Medical record number
- Examination date and time
2. Clinical Indication
- Reason for examination
- Relevant clinical history
- Specific clinical question to be answered
- Example: "Rule out pulmonary embolism in patient with acute dyspnea"
3. Technique
- Imaging modality (X-ray, CT, MRI, ultrasound, PET, etc.)
- Anatomical region examined
- Contrast administration (type, route, volume)
- Protocol or sequence used
- Technical quality and limitations
- Example: "Contrast-enhanced CT of the chest, abdomen, and pelvis was performed using 100 mL of intravenous iodinated contrast. Oral contrast was not administered."
4. Comparison
- Prior imaging studies available for comparison
- Dates of prior studies
- Stability or change from prior imaging
- Example: "Comparison: CT chest from [date]"
5. Findings
- Systematic description of imaging findings
- Organ-by-organ or region-by-region approach
- Positive findings first, then pertinent negatives
- Measurements of lesions or abnormalities
- Use of standardized terminology (ACR lexicon, RadLex)
- Example:
- Lungs: Bilateral ground-glass opacities, predominant in the lower lobes. No consolidation or pleural effusion.
- Mediastinum: No lymphadenopathy. Heart size normal.
- Abdomen: Liver, spleen, pancreas unremarkable. No free fluid.
6. Impression/Conclusion
- Concise summary of key findings
- Answers to the clinical question
- Differential diagnosi
Content truncated.
When not to use it
- →Casual non-clinical medical notes
- →Environments where AI-assisted health writing is restricted
Prerequisites
Limitations
- →Requires human physician review for final validation
- →Cannot access sensitive live EHR data without secure integration
How it compares
It mandates the inclusion of AI-generated scientific visualizations as a requirement for all clinical reports.
Compared to similar skills
clinical-reports side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| clinical-reports (this skill) | 3 | 7mo | Review | Advanced |
| ml-paper-writing | 48 | 6mo | Review | Advanced |
| content-research-writer | 15 | 9mo | No flags | Beginner |
| research-grants | 6 | 7mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by davila7
View all by davila7 →You might also like
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
content-research-writer
ComposioHQ
Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
research-grants
davila7
Write competitive research proposals for NSF, NIH, DOE, and DARPA. Agency-specific formatting, review criteria, budget preparation, broader impacts, significance statements, innovation narratives, and compliance with submission requirements.
nsfc-research-content-writer
huangwb8
为 NSFC 正文"(二)研究内容"写作/重构,并同步编排"特色与创新"和"三年年度研究计划",输出可直接落到 LaTeX 模板的三个 extraTex 文件。适用于用户要写/改"研究内容、研究目标、关键科学问题、技术路线、创新点、三年计划/里程碑"等场景。
business-knowledge-workflow
TencentBlueKing
业务知识获取与 Skill 文档编写工作流。当用户需要熟悉新业务模块、从 iWiki 获取文档、结合代码分析生成架构文档、或将业务知识沉淀为 Skill 时使用。
product-wiki
Terry-Mao
Maintain the product LLM Wiki under docs/product/wiki, including raw-doc ingestion, compiled summaries and concepts, query guidance, structural lint rules, and staged review handling for uncertain product knowledge.