nhi-cql-validator

What problem does it solve?

This Skill validates Taiwan NHI CQL Libraries (.cql) and FHIR ValueSet (.json) files for correctness and regulatory compliance. It performs syntax and format checks, ValueSet validation, and optional business-logic validation against official NHI rules, with auto-fix available on request. It supports cross-file validation and batch processing to streamline quality assurance for CQL-based decision support.

Core Features & Use Cases

• Syntax & Format Validation: Checks CQL structure, headers, indentation, and quotes.
• ValueSet Validation: Verifies JSON ValueSet structure, URL usage, and code coverage against rules.
• Business Logic Validation: Compares CQL logic against provided NHI rules to assess coverage.
• Auto-fix (optional): Automatically corrects formatting issues or placeholders when explicitly requested.
• Batch Processing: Validate multiple CQL and ValueSet files in a single run.

Quick Start

• Validate a CQL file: 請驗證這個 CQL 檔案：[path/to/file.cql]
• Validate a ValueSet: 請驗證這個 ValueSet 檔案：[path/to/file.json]
• Run batch validation: 請驗證這個目錄下的所有 CQL 和 ValueSet：[path/to/dir]