Use when assessing how well a survival model's predicted probabilities agree with observed outcomes by fitting a Cox model and generating bootstrap calibration curves at one or more prediction horizons from a clinical CSV file. NOT for: nomogram construction, univariate Cox screening, ROC analysis, or decision-curve analysis.
Use when assessing how well a survival model's predicted probabilities agree with observed outcomes by fitting a Cox model and generating bootstrap calibration curves at one or more prediction horizons from a clinical CSV file. NOT for: nomogram construction, univariate Cox screening, ROC analysis, or decision-curve analysis.
license
MIT
skill-author
AIPOCH
Model Calibration Curve
When to Use
Use this skill when you need to:
validate a survival model with bootstrap calibration curves;
compare predicted and observed survival probabilities at multiple horizons;
export calibration statistics together with a PDF visualization.
Typical user requests:
"Generate 1-, 2-, and 3-year calibration curves for this prognosis model."
"Check whether the Cox model built from age, gender, and risk is well calibrated."
"Export calibration statistics and a calibration PDF from this clinical cohort."
When Not to Use
Do not use this skill for:
nomogram construction;
univariate or multivariable Cox feature screening;
ROC, calibration-free discrimination, or decision-curve analysis;
non-survival endpoints or multiclass classification tasks.
When to Read External Files
Situation
File to Read
Purpose
Need algorithm details
references/algorithm.md
Statistical method and formulas
Need to run analysis
scripts/main.R
Get the complete command
Encounter errors
references/troubleshooting.md
Find solutions
Need CLI examples
references/cli-guide.md
Parameter usage examples
Input Validation
This skill accepts:
A clinical CSV file with sample IDs as row names, survival time, event indicator, and pre-selected prognostic features
Requests to assess calibration of a survival (Cox) model via bootstrap resampling at one or more prediction horizons
If the user's request does not involve survival model calibration from a clinical CSV file — for example, asking to construct a nomogram, screen Cox features, generate an ROC curve, analyze a decision curve, or work with non-survival outcomes — do not proceed with this workflow. Instead respond:
"model-calibration-curve is designed to validate survival model calibration by generating bootstrap calibration curves from a clinical CSV file. Your request appears to be outside this scope. Please use a nomogram-construction skill for nomogram building, a roc-diagnostic-performance skill for ROC analysis, or a decision-curve-analysis skill for DCA."
Note: --help requires optparse to be loaded. If the package check fires before option parsing, install optparse first, then run --help. The root fix (deferring heavy package checks until after argument parsing) must be applied in scripts/main.R.