risk-adjustment

Calculate CMS-HCC risk adjustment factors and identify coding gaps via ICD-10 mapping.

13|5|Updated May 4, 2026
One-click install
npx skills add https://github.com/awslabs/hcls-agent-skills --skill risk-adjustment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: risk-adjustment
Source: https://github.com/awslabs/hcls-agent-skills/tree/main/skills/risk-adjustment
Command: npx skills add https://github.com/awslabs/hcls-agent-skills --skill risk-adjustment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas.

What problem does it solve?

This skill automates the complex, error-prone process of CMS-HCC risk adjustment, ensuring accurate RAF score calculation and identifying critical coding gaps that impact revenue and patient care.

Core Features & Use Cases

  • ICD-10-to-HCC Mapping: Programmatically map diagnosis codes to condition categories while enforcing provider-type eligibility.
  • Hierarchy Resolution: Automatically resolve disease hierarchies to ensure only the highest-severity condition is counted for risk scoring.
  • Coding Gap Detection: Identify suspected coding gaps by analyzing Rx and lab proxies against existing diagnosis records.

Quick Start

Use the risk adjustment skill to calculate RAF scores and identify coding gaps for the provided member diagnosis and demographic datasets.

Frequently Asked Questions about risk-adjustment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate CMS-HCC risk adjustment factors in Python?

To calculate CMS-HCC risk adjustment factors in Python, you programmatically map ICD-10 diagnosis codes to condition categories and apply coefficient-based scoring to determine the RAF score. This requires pandas for data manipulation.

How does hierarchy resolution work for HCC risk scoring?

Disease hierarchy resolution for HCC risk scoring ensures only the highest-severity condition is counted. It automatically resolves overlapping diagnosis categories to prevent inflation of the final RAF score.

What is the best way to detect clinical coding gaps using lab and Rx proxies?

Detecting clinical coding gaps using lab and Rx proxies involves analyzing prescription and laboratory data against existing diagnosis records. This proxy-based gap detection identifies suspected undocumented conditions impacting revenue cycle management.

Can I use pandas to automate end-to-end RAF score pipelines?

Yes, you can use pandas to automate end-to-end RAF score pipelines. The framework supports data manipulation for ICD-10 mapping, hierarchy resolution, and coefficient-based scoring across member diagnosis and demographic datasets.

Do I need provider-type eligibility rules for ICD-10 to HCC mapping?

Yes, provider-type eligibility rules are required for ICD-10 to HCC mapping. Enforcing provider-type eligibility ensures only valid diagnoses from authorized practitioners are counted in the risk adjustment calculation.