nomogram-construction
Use when constructing a prognosis nomogram from survival-related clinical predictors, exporting the nomogram bundle and C-index table, and optionally rendering the final nomogram PDF. NOT for: univariate/multivariable Cox feature screening, calibration curves, ROC analysis, decision-curve analysis, or non-survival outcomes.
Veto GatesRequired pass for any deployment consideration
| Dimension | Result | Detail |
|---|---|---|
| Scientific Integrity | PASS | No fabricated DOI, PMID, C-index values, or survival statistics; all values computed from provided clinical data via rms::cph. |
| Practice Boundaries | PASS | Explicitly not for clinical diagnosis; skill is scoped to nomogram construction from pre-selected predictors only. |
| Methodological Ground | PASS | rms::cph is the canonical Cox model implementation for nomogram construction in R; C-index computation is methodologically correct; minimum sample/event requirements prevent invalid model fitting. |
| Code Usability | PASS | All 6 R modules syntactically valid; withCallingHandlers/tryCatch pattern correct; qs serialization for portable bundle storage. |
Core Capability98 / 100 — 8 Categories
Medical TaskExecution Average: 94.8 / 100 — Assertions: 20/20 Passed
Full build: validate CSV -> complete-case filter -> cph() -> nomogram() -> C-index -> .qs + .rds + .xlsx. All 4 expected output files generated.
4 predictors including categorical (gender, treatment) converted to factors automatically. C-index computed for 4-predictor model.
SKILL_INSUFFICIENT_DATA raised: requires >= 20 complete samples and >= 10 events. No partial model saved. Error message identifies specific requirements.
Plot mode: load .qs bundle -> validate required objects -> render PDF with custom width=12 and font_size=10.
8 predictors accepted; custom years 1,3,5 parsed; timeout enforced at 120s via apply_time_limit.
Key Strengths
- rms::cph is the methodologically correct foundation for Cox-based nomograms in R; C-index computation is standard and well-validated.
- Two-mode separation (build vs plot) with .qs bundle enables efficient iteration on visualization without re-running expensive Cox fitting — excellent design for clinical researchers.
- Comprehensive SKILL_* error table with 9 distinct codes including SKILL_ANALYSIS_ERROR covering cph() fitting failures that other skills may silently swallow.
- --overwrite guard prevents accidental output directory corruption during repeated test runs.