← Back to Skills

icd10-code-lookup

v1.0.0 approved Knowledge updated today
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ Download
Install Guide↓
🤖 Agent install commands (curl / MCP / Claude Desktop)
▸ curl one-liner
curl -L -o icd10-code-lookup.skill   "https://aiskillstore.io/v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=ClaudeCode"
▸ MCP tool call (after registering Skill Store MCP)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "4b2feb2d-a9da-4394-bd5f-4710af5251a7",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP config (one-time)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 Full agent API guide: /llms.txt  ·  MCP server card

Look up, validate, search, and traverse the hierarchy of ICD-10-CM FY2026 diagnosis codes. Bundled offline data — no external API needed. Prevents insurance claim rejections and medical record errors caused by invalid or hallucinated diagnosis codes.

Basic Info

Owner 👤 aiskillstore-team Category Knowledge Registered 2026-06-17 Last Updated 2026-06-17 Latest Version 1.0.0 Packaged At 2026-06-17 Vetting Status approved Downloads 0 Checksum (SHA256) b0b92fe4c6313b469413475a5dc09dc2b0b89a271ba92a2503f73ad5812c1d48

⚡ AGENT INFO USK v3

Capabilities
icd10_lookup medical_code_validation diagnosis_code_search healthcare_coding icd_hierarchy
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: main.py   runtime: python3   call_pattern: stdin_stdout
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=OpenClaw GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=ClaudeCode GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=Cursor GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=GeminiCLI GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=CodexCLI GET /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=CustomAgent

Installation

Compatible Platforms any

1
Install the skill using openclaw_skill_manager.py.
python openclaw_skill_manager.py --install icd10-code-lookup
2
Verify installation
python openclaw_skill_manager.py --list-installed
3
Install a specific version (optional)
python openclaw_skill_manager.py --install icd10-code-lookup --version 1.0.0
1
Download the skill package.
curl -O https://aiskillstore.io/v1/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download
2
Place it in the Claude Code commands directory.
unzip icd10-code-lookup.skill -d ~/.claude/commands/icd10-code-lookup/
3
Use it as a slash command in Claude Code.
/icd10-code-lookup
1
Download the Agent Skills package.
curl -O https://aiskillstore.io/v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=ClaudeCodeAgentSkill
2
Unzip it into the Claude Code skills directory.
unzip icd10-code-lookup-agent-skill-*.skill -d ~/.claude/skills/icd10-code-lookup/
3
Restart Claude Code — the skill is auto-loaded at session start. No slash command needed.
1
Download the Cursor-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=Cursor
2
Unzip and place it in a permanent location.
unzip icd10-code-lookup-cursor-*.skill -d ~/.cursor/skills/icd10-code-lookup/
3
Add the MCP server config to .cursor/mcp.json, then restart Cursor.
cat ~/.cursor/skills/icd10-code-lookup/cursor_mcp_config.json
1
Download the Gemini CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=GeminiCLI
2
Unzip and place it in a permanent location.
unzip icd10-code-lookup-geminicli-*.skill -d ~/.gemini/skills/icd10-code-lookup/
3
Add the MCP server config to ~/.gemini/settings.json, then restart Gemini CLI.
cat ~/.gemini/skills/icd10-code-lookup/gemini_settings_snippet.json
1
Download the Codex CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download?platform=CodexCLI
2
Unzip and place it in a permanent location.
unzip icd10-code-lookup-codexcli-*.skill -d ~/.codex/skills/icd10-code-lookup/
3
Add the MCP server config to ~/.codex/config.toml, then restart Codex CLI.
cat ~/.codex/skills/icd10-code-lookup/codex_config_snippet.toml
1
Download the skill package via REST API.
GET https://aiskillstore.io/v1/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/download
2
Place it in your agent platform's skills directory.
cp icd10-code-lookup.skill ./skills/
3
Fetch platform-specific details via the Install Guide API.
GET https://aiskillstore.io/v1/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/install-guide?platform=CustomAgent

Security Vetting Report

Vetting Result APPROVED

Findings: ["메타데이터 경고: 권장 필드 없음: 'tags' (SKILL.md v2 권장)", "메타데이터 경고: 권장 필드 없음: 'requirements' (SKILL.md v2 권장)", "메타데이터 경고: 권장 필드 없음: 'changelog' (SKILL.md v2 권장)"]

✅ No security risks found.

AI Review Stage

Reviewer gemini Risk Level 🟢 Low Review Summary ICD-10-CM 코드 조회, 유효성 검사, 검색 및 계층 구조 탐색 기능을 제공하는 안전하고 잘 구현된 스킬입니다. 번들된 오프라인 데이터를 사용하며 외부 통신이 없습니다.

Issues Found

  • 메타데이터에 'permissions.filesystem: false'로 선언되어 있으나, 스킬이 자체 번들 데이터 파일(icd10cm_fy2026.json.gz)을 읽기 위해 'os.path.exists' 및 'gzip.open'을 사용합니다. 이는 스킬의 핵심 기능(번들된 오프라인 데이터 사용)에 필수적인 읽기 전용 작업이며 자체 패키지 내로 제한되지만, 엄격한 의미에서는 파일 시스템 접근에 해당합니다.
Reasoning

제공된 스킬 메타데이터와 코드 파일을 분석한 결과는 다음과 같습니다. 1. **선언된 permissions(network/filesystem/subprocess)과 실제 코드가 일치하는가?** * `network: false`: 코드에서 `requests`, `socket` 등 네트워크 관련 모듈 사용이 발견되지 않았습니다. 스킬 설명에 'no external API needed'라고 명시되어 있으며, 번들된 로컬 데이터를 사용하므로 선언과 일치합니다. * `subprocess: false`: 코드에서 `subprocess` 모듈 사용이 발견되지 않았습니다. 선언과 일치합니다. * `filesystem: false`: `lib/loader.py`에서 `os.path.exists()`와 `gzip.open()`을 사용하여 스킬 패키지 내에 번들된 `icd10cm_fy2026.json.gz` 파일을 읽습니다. 이는 스킬의 핵심 기능인 '번들된 오프라인 데이터'를 사용하기 위한 필수적인 읽기 전용 작업입니다. 비록 메타데이터의 'filesystem: false' 선언과 엄격하게 일치하지는 않지만, 임의의 파일 시스템 접근이나 쓰기 작업이 아니며, 자체 번들 데이터에 대한 접근은 일반적으로 샌드박스 환경에서 허용되거나 예상되는 동작으로 간주될 수 있습니다. 이로 인한 보안 위험은 매우 낮습니다. 2. **악의적 목적의 코드가 있는가?** * 데이터 탈취, 시스템 파괴, 난독화 등 악의적인 목적으로 의심되는 코드는 발견되지 않았습니다. 코드는 명확하고 가독성이 높으며, ICD-10-CM 코드 처리라는 스킬의 목적에 충실합니다. 3. **선언되지 않은 외부 통신이 있는가?** * 외부 API 호출이나 네트워크 통신을 시도하는 코드는 전혀 발견되지 않았습니다. 스킬 설명과 일치하게 모든 작업은 로컬에서 이루어집니다. 4. **사용자 데이터를 무단으로 수집하거나 전송하는가?** * 사용자 입력(ICD-10 코드, 검색어)을 처리하고 결과를 반환하는 것 외에, 사용자 데이터를 저장, 로깅 또는 외부로 전송하는 어떠한 메커니즘도 발견되지 않았습니다. 5. **코드 품질이 스킬의 목적과 일치하는가?** * 코드는 모듈화가 잘 되어 있고, 명확한 함수명과 주석을 포함하고 있습니다. JSON 파싱 오류, 필수 파라미터 누락 등 입력 유효성 검사 및 오류 처리가 잘 구현되어 있습니다. 데이터 로딩을 위한 캐싱 메커니즘도 효율적입니다. 전반적으로 스킬의 목적에 부합하는 높은 품질의 코드입니다. **결론:** 'filesystem: false' 선언과 번들 데이터 읽기 간의 사소한 기술적 불일치가 있지만, 이는 스킬의 핵심 기능에 필수적이며 보안 위험이 매우 낮은 읽기 전용 작업입니다. 그 외에는 모든 보안 검수 기준을 충족하며, 악의적인 코드나 외부 통신 시도 없이 안전하게 작동합니다. 따라서 'approved'로 판단합니다.

Version History

Version USK v3 Vetting Status Packaged At Downloads Changelog
v1.0.0 approved 2026-06-17 ⬇ 0

Examples 6

Representative input/output examples for this skill. Agents can use these to understand how to invoke the skill and what output to expect.

validate_pneumonia
# validate# respiratory# pneumonia

Validate ICD-10-CM code J18.9 for pneumonia — confirm it exists in FY2026 data

📥 Input
{
  "action": "validate",
  "code": "J18.9"
}
📤 Output
{
  "action": "validate",
  "billable": true,
  "code": "J18.9",
  "description": "Pneumonia, unspecified organism",
  "fiscal_year": "FY2026",
  "hierarchy": {
    "block": "Influenza and pneumonia (J09-J18)",
    "category": "Pneumonia, unspecified organism (J18)",
    "chapter": "Diseases of the respiratory system (J00-J99)",
    "subcategory": null
  },
  "valid": true
}
lookup_diabetes_type2
# lookup# diabetes# endocrine

Look up E11.9 — Type 2 diabetes mellitus without complications

📥 Input
{
  "action": "lookup",
  "code": "E11.9"
}
📤 Output
{
  "action": "lookup",
  "billable": true,
  "code": "E11.9",
  "description": "Type 2 diabetes mellitus without complications",
  "fiscal_year": "FY2026",
  "hierarchy": {
    "block": "Diabetes mellitus (E08-E13)",
    "category": "Type 2 diabetes mellitus (E11)",
    "chapter": "Endocrine, nutritional and metabolic diseases (E00-E89)",
    "subcategory": null
  }
}
search_hypertension
# search# hypertension# circulatory

Search diagnosis codes related to hypertension, limit to top 5 results

📥 Input
{
  "action": "search",
  "max_results": 5,
  "query": "hypertension"
}
📤 Output
{
  "action": "search",
  "fiscal_year": "FY2026",
  "query": "hypertension",
  "results": [
    {
      "billable": true,
      "code": "I10",
      "description": "Essential (primary) hypertension",
      "score": 3.5
    },
    {
      "billable": true,
      "code": "I11.0",
      "description": "Hypertensive heart disease with heart failure",
      "score": 2.5
    },
    {
      "billable": true,
      "code": "I11.9",
      "description": "Hypertensive heart disease without heart failure",
      "score": 2.5
    },
    {
      "billable": true,
      "code": "I12.9",
      "description": "Hypertensive chronic kidney disease with stage 1 through stage 4 chronic kidney disease, or unspecified chronic kidney disease",
      "score": 2.5
    },
    {
      "billable": true,
      "code": "I13.10",
      "description": "Hypertensive heart and chronic kidney disease without heart failure, with stage 1 through stage 4 chronic kidney disease, or unspecified chronic kidney disease",
      "score": 2.5
    }
  ],
  "returned": 5,
  "total_matches": 47
}
validate_invalid_code
# validate# error# invalid

Validate a nonexistent code XYZ.999 — expect INVALID_CODE_FORMAT error

📥 Input
{
  "action": "validate",
  "code": "XYZ.999"
}
📤 Output
{
  "action": "validate",
  "code": "XYZ.999",
  "description": null,
  "error_code": "INVALID_CODE_FORMAT",
  "error_message": "\u0027XYZ.999\u0027 does not match ICD-10-CM format (e.g. J18.9)",
  "fiscal_year": "FY2026",
  "valid": false
}
hierarchy_lung_cancer
# hierarchy# neoplasm# lung

Traverse the full chapter-to-subcategory hierarchy for C34.10 (lung cancer)

📥 Input
{
  "action": "hierarchy",
  "code": "C34.10"
}
📤 Output
{
  "action": "hierarchy",
  "ancestors": [
    {
      "billable": false,
      "code": "C34",
      "description": "Malignant neoplasm of bronchus and lung"
    },
    {
      "billable": false,
      "code": "C34.1",
      "description": "Malignant neoplasm of upper lobe, bronchus or lung"
    }
  ],
  "billable": true,
  "code": "C34.10",
  "description": "Malignant neoplasm of upper lobe, unspecified bronchus or lung",
  "fiscal_year": "FY2026",
  "hierarchy": {
    "block": "Malignant neoplasms of respiratory and intrathoracic organs (C30-C39)",
    "category": "Malignant neoplasm of bronchus and lung (C34)",
    "chapter": "Neoplasms (C00-D49)",
    "subcategory": "Malignant neoplasm of upper lobe, bronchus or lung (C34.1)"
  }
}
search_diabetes_limited
# search# diabetes# endocrine

Search 'diabetes' limited to 5 results — agents can iterate with offset logic

📥 Input
{
  "action": "search",
  "max_results": 5,
  "query": "diabetes"
}
📤 Output
{
  "action": "search",
  "fiscal_year": "FY2026",
  "query": "diabetes",
  "results": [
    {
      "billable": false,
      "code": "E08",
      "description": "Diabetes mellitus due to underlying condition",
      "score": 3.0
    },
    {
      "billable": false,
      "code": "E09",
      "description": "Drug or chemical induced diabetes mellitus",
      "score": 3.0
    },
    {
      "billable": false,
      "code": "E10",
      "description": "Type 1 diabetes mellitus",
      "score": 3.0
    },
    {
      "billable": false,
      "code": "E11",
      "description": "Type 2 diabetes mellitus",
      "score": 3.0
    },
    {
      "billable": false,
      "code": "E13",
      "description": "Other specified diabetes mellitus",
      "score": 3.0
    }
  ],
  "returned": 5,
  "total_matches": 1264
}

All examples are also available via the agent API: /v1/agent/skills/4b2feb2d-a9da-4394-bd5f-4710af5251a7/schema

Reviews & Ratings

No reviews yet. Be the first to leave one!

✍️ Write a Review