CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

km-survival-curve

Use when generating Kaplan-Meier survival curves from tabular survival data containing time, event status, and a precomputed risk group. Supports command-line parameter input, parameter validation, automatic time-unit handling, single-file PDF figure export, and session metadata capture.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable CLI skill document with clear argument reference tables and good progressive disclosure into references/. Its main weaknesses are repeated auto-convert-days guidance and duplicated error entries (conciseness), and Quick Examples/Validation commands that reference test datasets missing from the bundle, which undermines both executability and navigation.

Suggestions

Consolidate the auto_convert_days guidance into a single section — it is currently explained in the Core Arguments table, two Input Requirements bullets, and four Time Conversion Caution bullets.

Merge the duplicate Common Errors entries (SKILL_INVALID_DATA and SKILL_INVALID_PARAMETER each appear twice) or move the full error catalogue to references/troubleshooting.md and keep only a pointer.

Either include tests/data/km_sample1.txt–km_sample3.txt in the bundle or rewrite the Quick Examples and Validation commands to use a user-supplied input path, since the referenced sample files do not exist.

DimensionReasoningScore

Conciseness

The core sections are operational and free of concept re-teaching, but the auto_convert_days guidance is stated three times (arguments table, Input Requirements bullets, and the Time Conversion Caution section), SKILL_INVALID_DATA and SKILL_INVALID_PARAMETER each appear twice in Common Errors, and the 25-row plot-customization table overlaps references/cli-guide.md. This is more than minor trimming — it is noticeable redundancy.

3 / 5

Actionability

Guidance is concrete throughout: copy-paste Rscript commands, complete argument tables, an example data row, and an expected output tree. However, every Quick Example and the Validation section invoke tests/data/km_sample1.txt–km_sample3.txt, which do not exist in the bundle, so those commands are not runnable as written.

4 / 5

Workflow Clarity

The Minimal Workflow gives a clear sequence with an explicit output check ('Check the output directory for km-plot.pdf') and error routing to references/troubleshooting.md. Not a 5 because the validation steps depend on the missing sample datasets and error recovery stops at 'read troubleshooting.md' rather than a validate-fix-retry loop.

4 / 5

Progressive Disclosure

The 'Read These Files When Needed' need-to-file table provides well-signaled one-level-deep navigation, and references/algorithm.md, references/cli-guide.md, references/troubleshooting.md, and scripts/main.R all exist. Not a 5 because the body repeatedly references tests/data/* files absent from the bundle, and scripts/utils.R and scripts/run_analysis.R are never mentioned.

4 / 5

Total

15

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'Use when' trigger with a concrete data-shape condition, and a comprehensive list of specific capabilities in third-person voice. The only gap is a handful of natural synonym triggers (e.g., 'KM curve', 'survival analysis').

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full pipeline — 'generating Kaplan-Meier survival curves from tabular survival data', 'parameter validation', 'automatic time-unit handling', 'single-file PDF figure export', and 'session metadata capture'. Coverage of the skill's scope is comprehensive rather than leaving minor gaps.

5 / 5

Completeness

It explicitly answers both questions: an explicit 'Use when generating Kaplan-Meier survival curves from tabular survival data containing time, event status, and a precomputed risk group' trigger clause with a concrete data shape, and a clear 'what' enumerating supported capabilities. The 'when' is specific, not merely adequate.

5 / 5

Trigger Term Quality

Natural terms like 'Kaplan-Meier', 'survival curves', 'survival data', and 'risk group' are present and would be said by users needing this skill. Common variations such as 'KM curve', 'survival analysis', or 'log-rank' are missing, which keeps it just below comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

Kaplan-Meier curve generation from a precomputed grouping is a clear niche with distinct triggers and minimal conflict risk; the 'precomputed risk group' phrasing even fences off cutoff-derivation skills. No closely related skill would plausibly capture these triggers.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

awesome-med-research-skills/Data Analysis/km-survival-curve/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.