
Cardiovascular Risk
- 1 installs
- 1 repo stars
- Updated February 4, 2026
- rhavekost/clinical-toolkit
Guides input collection, calculation, and interpretation for cardiovascular risk scores like ASCVD PCE, CHA2DS2-VASc, HAS-BLED, HEART, CURB-65, and Wells.
About
Provides structured calculation and interpretation for common cardiovascular risk and decision scores. Clinicians use it to estimate ASCVD, stroke, bleeding, pneumonia severity and VTE probability with safety caveats.
- Covers ASCVD PCE, CHA2DS2-VASc, HAS-BLED, Framingham, HEART, CURB-65 and Wells
- Interactive input collection, calculation and interpretation with limitations
Cardiovascular Risk by the numbers
- 1 all-time installs (skills.sh)
- Ranked #2,479 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/rhavekost/clinical-toolkit --skill cardiovascular-riskAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1 |
|---|---|
| repo stars | ★ 1 |
| Last updated | February 4, 2026 |
| Repository | rhavekost/clinical-toolkit ↗ |
What it does
Guides input collection, calculation, and interpretation for cardiovascular risk scores like ASCVD PCE, CHA2DS2-VASc, HAS-BLED, HEART, CURB-65, and Wells.
Files
Cardiovascular Risk and Decision Tools
Description
This skill provides structured calculation guidance for commonly used cardiovascular risk scores and related decision tools. It supports accurate input collection, calculation, interpretation, and safety caveats.
Quick Reference
| Tool | Use |
|---|---|
| ASCVD Pooled Cohort Equations | 10-year ASCVD risk estimation |
| CHA2DS2-VASc | Stroke risk in atrial fibrillation |
| HAS-BLED | Major bleeding risk in anticoagulated patients |
| Framingham Risk Score | 10-year cardiovascular risk (general CVD) |
| HEART Score | Chest pain risk stratification |
| CURB-65 | Pneumonia severity and disposition support |
| Wells (DVT) | DVT pretest probability |
| Wells (PE) | Pulmonary embolism pretest probability |
Interactive Mode (Lightweight)
1. Confirm clinical context and intended tool. 2. Collect required inputs with units and timing. 3. Validate inputs and resolve missing data. 4. Calculate and present results with interpretation. 5. Provide safety caveats and limitations.
Calculators
- ASCVD Pooled Cohort Equations
- CHA2DS2-VASc
- HAS-BLED
- Framingham Risk Score
- HEART Score
- CURB-65
- Wells Score (DVT)
- Wells Score (PE)
Safety and Limitations
- Support tool only; not diagnostic or prescriptive.
- Use local policies and clinical judgment.
- Many tools have population limits and invalid ranges.
References
See: references/cardiovascular-risk-sources.md
ASCVD Pooled Cohort Equations (PCE)
Purpose
Estimate 10-year atherosclerotic cardiovascular disease (ASCVD) risk for primary prevention.
Intended Population
Adults ages 40 to 79 without established ASCVD. Derived for non-Hispanic White and African American populations. Use caution in other populations.
Inputs
| Name | Unit | Required | Valid Range | Notes |
|---|---|---|---|---|
| Age | years | Yes | 40 to 79 | Use completed years |
| Sex | male/female | Yes | - | Biological sex used in equation |
| Race | White or African American | Yes | - | Use closest population with caution |
| Total cholesterol | mg/dL | Yes | >0 | - |
| HDL cholesterol | mg/dL | Yes | >0 | - |
| Systolic BP | mmHg | Yes | >0 | - |
| BP treatment | yes/no | Yes | - | Use treated vs untreated coefficients |
| Current smoker | yes/no | Yes | - | Current cigarette use |
| Diabetes | yes/no | Yes | - | Clinician-diagnosed diabetes |
Algorithm
1. Compute natural logs for age, total cholesterol, HDL, and SBP. 2. Sum coefficients for the selected sex and race group. 3. Apply the risk equation:
Risk = 1 - S0 ^ exp(sum - mean)
Where S0 is baseline survival and mean is the mean coefficient sum for that group.
Coefficients (10-year ASCVD)
White Women
| Term | Coefficient |
|---|---|
| ln(age) | -29.799 |
| ln(age)^2 | 4.884 |
| ln(TC) | 13.540 |
| ln(age) * ln(TC) | -3.114 |
| ln(HDL) | -13.578 |
| ln(age) * ln(HDL) | 3.149 |
| ln(SBP) treated | 2.019 |
| ln(SBP) untreated | 1.957 |
| Smoker | 7.574 |
| ln(age) * Smoker | -1.665 |
| Diabetes | 0.661 |
| Mean coefficient sum | -29.18 |
| Baseline survival (S0) | 0.9665 |
African American Women
| Term | Coefficient |
|---|---|
| ln(age) | 17.114 |
| ln(TC) | 0.940 |
| ln(HDL) | -18.920 |
| ln(age) * ln(HDL) | 4.475 |
| ln(SBP) treated | 29.291 |
| ln(age) * ln(SBP) treated | -6.432 |
| ln(SBP) untreated | 27.820 |
| ln(age) * ln(SBP) untreated | -6.087 |
| Smoker | 0.691 |
| Diabetes | 0.874 |
| Mean coefficient sum | 86.61 |
| Baseline survival (S0) | 0.9533 |
White Men
| Term | Coefficient |
|---|---|
| ln(age) | 12.344 |
| ln(TC) | 11.853 |
| ln(age) * ln(TC) | -2.664 |
| ln(HDL) | -7.990 |
| ln(age) * ln(HDL) | 1.769 |
| ln(SBP) treated | 1.797 |
| ln(SBP) untreated | 1.764 |
| Smoker | 7.837 |
| ln(age) * Smoker | -1.795 |
| Diabetes | 0.658 |
| Mean coefficient sum | 61.18 |
| Baseline survival (S0) | 0.9144 |
African American Men
| Term | Coefficient |
|---|---|
| ln(age) | 2.469 |
| ln(TC) | 0.302 |
| ln(HDL) | -0.307 |
| ln(SBP) treated | 1.916 |
| ln(SBP) untreated | 1.809 |
| Smoker | 0.549 |
| Diabetes | 0.645 |
| Mean coefficient sum | 19.54 |
| Baseline survival (S0) | 0.8954 |
Output
10-year ASCVD risk percentage.
Interpretation
Use guideline thresholds for risk categories and shared decision making. Risk estimates may under- or over-estimate in certain populations.
Limitations
- Not validated for patients with established ASCVD.
- Requires accurate lipid values and blood pressure status.
- Use caution in populations not represented in derivation cohorts.
Example Calculation
White male, age 55, TC 213, HDL 50, SBP 120 untreated, nonsmoker, no diabetes:
- 10-year ASCVD risk = 5.4% (rounded)
References
See: references/cardiovascular-risk-sources.md
CHA2DS2-VASc Score
Purpose
Estimate stroke risk in patients with nonvalvular atrial fibrillation.
Intended Population
Adults with atrial fibrillation or atrial flutter. Not intended for valvular AF.
Inputs
| Criterion | Points | Notes |
|---|---|---|
| Congestive heart failure or LV dysfunction | 1 | Clinical HF or reduced EF |
| Hypertension | 1 | Treated or untreated |
| Age >= 75 years | 2 | - |
| Diabetes mellitus | 1 | - |
| Stroke, TIA, or thromboembolism history | 2 | - |
| Vascular disease | 1 | Prior MI, PAD, or aortic plaque |
| Age 65 to 74 years | 1 | - |
| Sex category (female) | 1 | Biological sex |
Algorithm
Sum points across all criteria. Score range: 0 to 9.
Output
CHA2DS2-VASc total score.
Interpretation
Higher scores indicate higher annual stroke risk. Use local AF guidelines to determine anticoagulation thresholds.
Limitations
- Use clinical judgment and shared decision making.
- Not validated for rheumatic mitral stenosis or mechanical heart valves.
Example Calculation
Female, age 70, hypertension, diabetes, no prior stroke, no vascular disease:
- Age 65 to 74 = 1
- Female sex = 1
- Hypertension = 1
- Diabetes = 1
- Total score = 4
References
See: references/cardiovascular-risk-sources.md
CURB-65 Score
Purpose
Assess pneumonia severity and short-term mortality risk.
Intended Population
Adults with community-acquired pneumonia.
Inputs
| Criterion | Points | Notes |
|---|---|---|
| Confusion | 1 | New disorientation to person, place, or time |
| Urea | 1 | BUN >20 mg/dL (7 mmol/L) |
| Respiratory rate | 1 | >=30/min |
| Blood pressure | 1 | SBP <90 mmHg or DBP <=60 mmHg |
| Age | 1 | >=65 years |
Algorithm
Sum points across criteria. Score range: 0 to 5.
Output
CURB-65 total score.
Interpretation
Higher scores indicate higher mortality risk. Use local guidelines to determine disposition and treatment setting.
Limitations
- Designed for adult CAP; not validated in children.
- Does not replace clinical judgment or other severity markers.
Example Calculation
Age 72, BUN 24 mg/dL, RR 28, SBP 118, no confusion:
- Age 1 + Urea 1 = 2
References
See: references/cardiovascular-risk-sources.md
Framingham Risk Score (General CVD, 10-Year)
Purpose
Estimate 10-year risk of general cardiovascular disease (CVD).
Intended Population
Adults without known CVD. Derived from the Framingham Heart Study cohort.
Inputs
| Name | Unit | Required | Notes |
|---|---|---|---|
| Age | years | Yes | Use completed years |
| Total cholesterol | mg/dL | Yes | - |
| HDL cholesterol | mg/dL | Yes | - |
| Systolic BP | mmHg | Yes | - |
| BP treatment | yes/no | Yes | Use treated vs untreated coefficients |
| Smoking | yes/no | Yes | Current smoker |
| Diabetes | yes/no | Yes | Clinician-diagnosed diabetes |
| Sex | male/female | Yes | Biological sex used in equation |
Algorithm
1. Compute natural logs for age, total cholesterol, HDL, and SBP. 2. Sum coefficients for the selected sex. 3. Apply the risk equation:
Risk = 1 - S0 ^ exp(sum - mean)
Coefficients (Primary Model)
Men
| Term | Coefficient |
|---|---|
| ln(age) | 3.06117 |
| ln(TC) | 1.12370 |
| ln(HDL) | -0.93263 |
| ln(SBP) untreated | 1.93303 |
| ln(SBP) treated | 1.99881 |
| Smoker | 0.65451 |
| Diabetes | 0.57367 |
| Mean coefficient sum | 23.9802 |
| Baseline survival (S0) | 0.88936 |
Women
| Term | Coefficient |
|---|---|
| ln(age) | 2.32888 |
| ln(TC) | 1.20904 |
| ln(HDL) | -0.70833 |
| ln(SBP) untreated | 2.76157 |
| ln(SBP) treated | 2.82263 |
| Smoker | 0.52873 |
| Diabetes | 0.69154 |
| Mean coefficient sum | 26.1931 |
| Baseline survival (S0) | 0.95012 |
Output
10-year general CVD risk percentage.
Interpretation
Use local guidelines for risk thresholds. This model is older and may differ from contemporary risk tools such as ASCVD PCE.
Limitations
- Derived from a single cohort and may misestimate risk in other populations.
- Not intended for patients with established CVD.
Example Calculation
Male, age 55, TC 213, HDL 50, SBP 120 untreated, nonsmoker, no diabetes:
- 10-year CVD risk = 10.2% (rounded)
References
See: references/cardiovascular-risk-sources.md
HAS-BLED Score
Purpose
Estimate major bleeding risk in patients with atrial fibrillation receiving anticoagulation.
Intended Population
Adults with atrial fibrillation. Use to identify modifiable bleeding risk factors.
Inputs
| Criterion | Points | Notes |
|---|---|---|
| Hypertension | 1 | Systolic BP >160 mmHg |
| Abnormal renal function | 1 | Dialysis, transplant, or creatinine >=2.26 mg/dL (200 umol/L) |
| Abnormal liver function | 1 | Cirrhosis or bilirubin >2x with AST/ALT/AP >3x |
| Stroke history | 1 | Prior ischemic or hemorrhagic stroke |
| Bleeding history or predisposition | 1 | Prior major bleeding or anemia |
| Labile INR | 1 | TTR <60% or unstable INRs |
| Elderly | 1 | Age >65 years |
| Drugs | 1 | Antiplatelets or NSAIDs |
| Alcohol | 1 | >=8 drinks/week or excessive use |
Algorithm
Sum points across criteria. Abnormal renal and abnormal liver count separately. Drugs and alcohol count separately. Score range: 0 to 9.
Output
HAS-BLED total score.
Interpretation
Higher scores indicate higher bleeding risk. Use to address modifiable risk factors and guide monitoring intensity, not to withhold therapy by itself.
Limitations
- Applies to AF populations studied; interpret with clinical context.
- Risk scores do not replace individualized assessment.
Example Calculation
Male, age 72, hypertension, prior stroke, on NSAIDs, no renal or liver disease:
- Hypertension = 1
- Stroke history = 1
- Elderly = 1
- Drugs (NSAIDs) = 1
- Total score = 4
References
See: references/cardiovascular-risk-sources.md
HEART Score
Purpose
Risk stratify chest pain patients for short-term major adverse cardiac events (MACE).
Intended Population
Adults presenting with chest pain or possible acute coronary syndrome.
Inputs
Each category scores 0, 1, or 2 points.
| Category | 0 Points | 1 Point | 2 Points |
|---|---|---|---|
| History | Slightly suspicious | Moderately suspicious | Highly suspicious |
| ECG | Normal | Nonspecific repolarization changes | Significant ST depression |
| Age | <45 years | 45 to 64 years | >=65 years |
| Risk factors | None | 1 to 2 risk factors | >=3 risk factors or known atherosclerotic disease |
| Troponin | <= normal limit | 1 to 3x normal limit | >3x normal limit |
Common risk factors: hypertension, hyperlipidemia, diabetes, smoking, obesity, or family history of CAD.
Algorithm
Sum points across all categories. Score range: 0 to 10.
Output
HEART total score.
Interpretation
- 0 to 3: low risk
- 4 to 6: intermediate risk
- 7 to 10: high risk
Limitations
- Requires clinical judgment for history and ECG categories.
- Troponin interpretation depends on assay and reference ranges.
Example Calculation
Age 58, moderately suspicious history, nonspecific ECG changes, 2 risk factors, troponin normal:
- History 1 + ECG 1 + Age 1 + Risk factors 1 + Troponin 0 = 4 (intermediate risk)
References
See: references/cardiovascular-risk-sources.md
Wells Score (DVT)
Purpose
Estimate pretest probability of deep vein thrombosis (DVT).
Intended Population
Adults with suspected lower extremity DVT.
Inputs
| Criterion | Points | Notes |
|---|---|---|
| Active cancer | 1 | Treatment ongoing, within 6 months, or palliative |
| Paralysis, paresis, or recent immobilization of lower limb | 1 | - |
| Bedridden >=3 days or major surgery in past 12 weeks | 1 | Requires general or regional anesthesia |
| Localized tenderness along deep venous system | 1 | - |
| Entire leg swollen | 1 | - |
| Calf swelling >=3 cm | 1 | Measured 10 cm below tibial tuberosity |
| Pitting edema in symptomatic leg | 1 | - |
| Collateral superficial veins (non-varicose) | 1 | - |
| Alternative diagnosis at least as likely as DVT | -2 | - |
Algorithm
Sum points across criteria. Score range: -2 to 8.
Output
Wells DVT total score.
Interpretation (Two-Level)
- <=1: DVT unlikely
- >=2: DVT likely
Limitations
- Use with D-dimer and imaging per local protocols.
- Requires clinical judgment for alternative diagnosis.
Example Calculation
Active cancer, entire leg swollen, calf swelling >=3 cm, no alternative diagnosis:
- Score = 1 + 1 + 1 = 3 (DVT likely)
References
See: references/cardiovascular-risk-sources.md
Wells Score (PE)
Purpose
Estimate pretest probability of pulmonary embolism (PE).
Intended Population
Adults with suspected pulmonary embolism.
Inputs
| Criterion | Points | Notes |
|---|---|---|
| Clinical signs of DVT | 3 | Leg swelling and pain with palpation of deep veins |
| PE most likely diagnosis | 3 | No alternative diagnosis more likely |
| Heart rate >100 bpm | 1.5 | - |
| Immobilization >=3 days or surgery in previous 4 weeks | 1.5 | - |
| Previous DVT or PE | 1.5 | - |
| Hemoptysis | 1 | - |
| Malignancy | 1 | Treatment ongoing, within 6 months, or palliative |
Algorithm
Sum points across criteria. Score range: 0 to 12.5.
Output
Wells PE total score.
Interpretation (Two-Level)
- <=4: PE unlikely
- >4: PE likely
Limitations
- Use with D-dimer and imaging per local protocols.
- Requires clinical judgment for alternative diagnosis.
Example Calculation
Heart rate 110, recent surgery, hemoptysis, no DVT signs, PE most likely:
- Score = 1.5 + 1.5 + 1 + 3 = 7 (PE likely)
References
See: references/cardiovascular-risk-sources.md
Cardiovascular Risk Sources
Licensing Note
All scoring systems and formulas here are derived from published research or official guidelines and are freely implementable with proper citation. This project uses original descriptions and does not copy proprietary content.
ASCVD Pooled Cohort Equations
- ACC/AHA Guideline on the Assessment of Cardiovascular Risk (Circulation 2014). Coefficients and baseline survival values in the pooled cohort equations table.
- Goff DC Jr, et al. Circulation 2014;129:S49-S73. (Derivation and validation).
CHA2DS2-VASc
- Lip GYH, et al. Chest 2010;137:263-272. (Score derivation)
- AAFP clinical guidance table listing CHA2DS2-VASc criteria and points.
HAS-BLED
- Pisters R, et al. Chest 2010;138:1093-1100. (Score derivation)
- AAFP clinical guidance table listing HAS-BLED criteria and point definitions.
Framingham Risk Score (General CVD)
- Framingham Heart Study: General CVD risk profile coefficients and baseline survival values.
- D'Agostino RB Sr, et al. Circulation 2008;117:743-753. (General CVD risk profile).
HEART Score
- Six AJ, et al. (HEART score derivation and validation)
- HEART score application review (open access, PMC).
CURB-65
- NICE guideline NG250: Pneumonia in adults (CURB-65 criteria and risk stratification).
- Lim WS, et al. Thorax 2003;58:377-382. (Derivation of CURB-65).
Wells DVT and PE Scores
- NICE guideline NG158: Venous thromboembolic diseases (Wells criteria for DVT and PE, two-level interpretation).
- Wells PS, et al. Lancet 1997;350:1795-1798. (DVT score)
- Wells PS, et al. Ann Intern Med 2001;135:98-107. (PE score)