| name | esc-guidelines-query |
| description | Query ESC (European Society of Cardiology) Guidelines by automatically locating the relevant PDF from the TOC and extracting cited answers. Use when answering clinical questions about cardiovascular diseases based on official ESC recommendations. |
ESC Guidelines Query System
Expert system for querying ESC Guidelines with automatic PDF location and citation extraction.
When to Use This Skill
- Answering clinical cardiovascular questions
- Finding ESC recommendations on specific conditions
- Extracting diagnostic or therapeutic guidelines
- Locating specific ESC criteria or thresholds
- Comparing recommendations across different ESC guidelines
- Verifying treatment protocols against ESC standards
Core Workflow
This skill implements a 3-phase intelligent retrieval system:
Phase 1: TOC Analysis (Locate)
Goal: Identify which ESC guideline PDF contains the relevant information
Process:
- Read the master index:
ESC_GUIDELINES_TOC.md - Analyze the user's clinical question to extract:
- Medical condition (e.g., "aortic aneurysm", "atrial fibrillation")
- Specific aspect (e.g., "imaging", "treatment threshold", "follow-up")
- Clinical context (e.g., "45mm diameter", "pregnancy", "diabetes")
- Search the TOC using Grep with relevant keywords
- Identify the specific PDF file and page/section numbers
Example TOC Analysis:
User Question: "Si deve fare TAC se uno ha 45mm di aortic root?"
Keywords to search: aortic root, imaging, CT, TAC, surveillance, thoracic aorta, 45mm
TOC Result:
- File: 2024_Peripheral_Arterial_Aortic.pdf
- Section: 9.2.2 Thoracic aortic aneurysms (p. 66)
- Subsection: 9.2.2.4 Surveillance (p. 70)
- Imaging section: 5.4 Evaluation of the aorta (p. 25)
Phase 2: PDF Extraction (Read)
Goal: Read the specific sections from the identified PDF
Process:
- Open the PDF file identified in Phase 1
- Navigate to the specific sections/pages from the TOC
- Extract relevant content including:
- Recommendations (with class/level of evidence)
- Diagnostic criteria
- Threshold values
- Imaging protocols
- Follow-up schedules
- Capture exact quotes for citation
Reading Strategy:
Priority reading order:
1. Main section related to the question
2. Imaging/diagnostic section if relevant
3. Management/treatment section
4. Surveillance/follow-up section
5. Special populations section if applicable
Phase 3: Answer Synthesis (Cite)
Goal: Provide accurate answer with proper citations
Required Elements:
- ✅ Direct answer to the user's question
- ✅ ESC Recommendation (Class I/IIa/IIb/III, Level A/B/C)
- ✅ Exact citation (PDF file, section, page number)
- ✅ Clinical context (thresholds, conditions, exceptions)
- ✅ Related information (surveillance intervals, imaging modality choice)
Citation Format:
**ESC Recommendation** [Class I, Level B]:
"[Exact quote from PDF]"
**Source**: [2024_Peripheral_Arterial_Aortic.pdf] - Section 9.2.2.4 (p. 70)
Implementation Protocol
Step-by-Step Execution
## Phase 1: Locate (TOC Analysis)
1. **Parse User Question**
- Extract: condition, aspect, context
- Identify: relevant keywords for search
2. **Search TOC**
```bash
Grep pattern: [keywords from question]
File: ESC_GUIDELINES_TOC.md
Mode: content with context
- Identify Target PDF
- PDF filename: [extracted from TOC]
- Section numbers: [from TOC structure]
- Page numbers: [from TOC annotations]
Phase 2: Read (PDF Extraction)
Open Target PDF
Read: references/esc-guidelines/[PDF_filename].pdf Focus: Sections identified in Phase 1Extract Relevant Content
- Recommendations boxes/tables
- Diagnostic criteria
- Threshold values
- Imaging protocols
- Follow-up schedules
Capture Exact Quotes
- Copy verbatim text for citations
- Note recommendation class/level
- Record page numbers
Phase 3: Cite (Answer Synthesis)
Structure Answer
- Direct response to question
- ESC recommendation with class/level
- Exact citation with source
- Clinical context and nuances
Format Output
- Use markdown for clarity
- Include tables if comparing options
- Link to PDF file
- Provide page references
## Output Template
```markdown
# [Clinical Question]
## ESC Recommendation
**[Recommendation Class & Level]**: [Brief summary]
"[Exact quote from ESC Guidelines]"
## Clinical Context
- **Threshold/Criteria**: [Specific values]
- **Imaging Modality**: [Recommended method]
- **Surveillance**: [Follow-up interval]
- **Special Considerations**: [Risk factors, comorbidities]
## When to [Action]
| Condition | Recommendation | Evidence |
|-----------|----------------|----------|
| [Scenario 1] | [Action] | Class [X], Level [Y] |
| [Scenario 2] | [Action] | Class [X], Level [Y] |
## Source Citation
**PDF**: [[PDF_filename].pdf](references/esc-guidelines/[PDF_filename].pdf)
**Section**: [Section number and title]
**Pages**: [Page numbers]
## Additional Recommendations
[Related information from the same guideline]
Example Query Execution
User Question
"Si deve fare TAC se uno ha 45mm di aortic root?"
Phase 1: Locate
# Search TOC
Grep: "aortic root|imaging|CT|TAC|thoracic.*aneurysm|surveillance"
File: ESC_GUIDELINES_TOC.md
# Result
PDF: 2024_Peripheral_Arterial_Aortic.pdf
Sections:
- 5.4 Evaluation of the aorta (p. 25)
- 5.4.6 Cardiovascular computed tomography (p. 29)
- 9.2.2 Thoracic aortic aneurysms (p. 66)
- 9.2.2.4 Surveillance (p. 70)
Phase 2: Read
# Open PDF
Read: references/esc-guidelines/2024_Peripheral_Arterial_Aortic.pdf
# Extract from Section 5.4.6 (p. 29)
"CT angiography is the gold standard for aortic imaging..."
# Extract from Section 9.2.2.4 (p. 70)
"Surveillance with CT or MRI is recommended when aortic diameter is ≥45mm..."
[Recommendation Class I, Level B]
Phase 3: Cite
# Imaging per Aortic Root di 45mm
## ESC Recommendation
**Class I, Level B**: La sorveglianza con TC o RM è raccomandata quando il diametro aortico è ≥45mm.
"Surveillance imaging with CT or MRI is recommended when the aortic root diameter reaches 45mm or greater, with annual follow-up for diameters 45-49mm."
## Clinical Context
- **Threshold**: ≥45mm richiede imaging di conferma e sorveglianza
- **Imaging Modality**: TC angiografia (gold standard) o RM cardiovascolare
- **Surveillance Interval**: Annuale per 45-49mm
- **Surgery Threshold**: ≥50-55mm (salvo fattori di rischio)
## Indicazioni Specifiche per TC
| Condizione | Raccomandazione | Classe/Livello |
|------------|-----------------|----------------|
| Prima misurazione ≥45mm | TC o RM per conferma | Class I, Level C |
| Follow-up annuale | TC o RM | Class I, Level B |
| Valvola bicuspide + ≥45mm | TC annuale | Class I, Level B |
| Marfan + ≥45mm | TC ogni 6-12 mesi | Class I, Level C |
## Source Citation
**PDF**: [2024_Peripheral_Arterial_Aortic.pdf](references/esc-guidelines/2024_Peripheral_Arterial_Aortic.pdf)
**Sections**:
- 5.4.6 Cardiovascular computed tomography (p. 29)
- 9.2.2.4 Surveillance (p. 70)
## Additional Recommendations
- La TC senza contrasto può essere sufficiente per follow-up dimensionale
- La RM è preferibile in pazienti giovani per ridurre esposizione radiante
- L'ecocardiogramma può essere usato per screening ma non per decisioni chirurgiche
Best Practices
1. Keyword Selection
- Use medical synonyms (e.g., "myocardial infarction" = "MI" = "heart attack")
- Include Italian and English terms
- Search for abbreviations (e.g., "AF" for atrial fibrillation)
2. TOC Navigation
- Start with broad section search (e.g., "aorta", "arrhythmia")
- Narrow to specific subsections (e.g., "surveillance", "imaging")
- Check multiple related sections (diagnosis, treatment, follow-up)
3. PDF Reading
- Read tables first - often contain key recommendations
- Look for highlighted boxes - ESC recommendations are emphasized
- Check figures/algorithms - provide decision pathways
- Don't skip page headers - confirm you're in the right section
4. Citation Accuracy
- Quote exactly - don't paraphrase recommendations
- Include class/level - essential for clinical decision-making
- Provide page numbers - for user verification
- Link to PDF - enable direct access
5. Clinical Context
- Mention patient-specific factors (age, comorbidities)
- Note variations by condition (bicuspid valve, Marfan syndrome)
- Include surveillance schedules - not just one-time recommendations
- Highlight contraindications or special considerations
Common Pitfalls to Avoid
❌ Don't:
- Rely on TOC alone without reading the PDF
- Paraphrase recommendations (lose precision)
- Omit class/level of evidence
- Ignore special populations sections
- Miss related sections (e.g., imaging section when answering treatment question)
✅ Do:
- Cross-reference multiple sections
- Extract exact quotes
- Include all relevant thresholds
- Mention alternative approaches
- Cite page numbers for verification
Performance Optimization
Efficient TOC Search
# Use multiple keywords with OR
Grep: "aortic root|radice aortica|ascending aorta"
# Include Italian medical terms
Grep: "scompenso|insufficienza|ipertensione"
# Search for diagnostic terms
Grep: "imaging|CT|TAC|eco|RM|angio"
Parallel Reading
When question involves multiple aspects:
- Read diagnostic section (Phase 2a)
- Read treatment section (Phase 2b)
- Read surveillance section (Phase 2c)
- Synthesize all in Phase 3
Smart Caching
- Remember frequently accessed PDFs (e.g., 2024 guidelines)
- Note common sections for quick reference
- Build mental map of TOC structure
Advanced Query Patterns
Pattern 1: Comparative Questions
"Quale imaging è meglio per aneurisma aortico, TC o RM?"
Strategy:
- Locate imaging section in TOC
- Read both CT and MRI subsections
- Create comparison table with recommendations
- Cite both sections
Pattern 2: Threshold Questions
"A che diametro si opera l'aorta ascendente?"
Strategy:
- Locate surgical management section
- Extract all threshold values
- Note variations by condition
- Present as structured table
Pattern 3: Special Population Questions
"Come gestire aneurisma aortico in gravidanza?"
Strategy:
- Search TOC for "pregnancy" or "gravidanza"
- Check both main section + pregnancy subsection
- Extract pregnancy-specific recommendations
- Note differences from general population
Pattern 4: Multi-guideline Questions
"Le linee guida 2024 cambiano il management dell'aorta rispetto al 2020?"
Strategy:
- Locate same section in both TOCs
- Read both PDFs in parallel
- Create "What's new" comparison
- Cite both guidelines with year
Quality Checklist
Before delivering answer, verify:
- TOC was searched with comprehensive keywords
- Correct PDF was identified and opened
- Relevant sections were fully read (not just skimmed)
- Exact quotes were extracted (not paraphrased)
- Recommendation class and level are included
- Page numbers are accurate
- PDF filename and section are cited
- Clinical context is provided (thresholds, intervals)
- Special populations are mentioned if relevant
- Related recommendations are included
- Answer directly addresses user's question
Resources
- Primary Source:
ESC_GUIDELINES_TOC.md(Master index of all ESC guidelines) - PDF Repository:
references/esc-guidelines/(All ESC guideline PDFs) - Available Guidelines:
- 2024: Atrial Fibrillation, Chronic Coronary Syndromes, Hypertension, Peripheral Arterial & Aortic
- 2023: Acute Coronary Syndromes, Cardiomyopathies, CVD & Diabetes
- 2022: Cardio-oncology, Valvular Heart Disease
- 2021: Heart Failure, Pacing & CRT
- 2020: Adult Congenital Heart Disease, Sports Cardiology
Example Queries to Practice
- "Quali sono le indicazioni ESC per impianto ICD nella cardiomiopatia dilatativa?"
- "A che frazione di eiezione si considera scompenso cardiaco con FE ridotta?"
- "Quali anticoagulanti sono raccomandati in fibrillazione atriale con CHA2DS2-VASc ≥2?"
- "Quando si fa PCI vs CABG nella malattia coronarica cronica?"
- "Come gestire ipertensione in paziente con diabete secondo ESC 2024?"
Activation Prompt
When user asks a clinical question about cardiovascular disease:
- Activate this skill automatically
- Execute Phase 1: Search TOC for relevant PDF
- Execute Phase 2: Read identified PDF sections
- Execute Phase 3: Synthesize answer with exact citations
Remember: The goal is to provide evidence-based answers directly from ESC Guidelines, not general medical knowledge. Always cite the source with precision.