nhi-cql-validator

Validate Taiwan NHI CQL Libraries and FHIR ValueSet files for compliance.

1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/edwardlo12/CQL-Skills --skill nhi-cql-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nhi-cql-validator
Source: https://github.com/edwardlo12/CQL-Skills/tree/main/skills/nhi-cql-validator
Command: npx skills add https://github.com/edwardlo12/CQL-Skills --skill nhi-cql-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

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]

Frequently Asked Questions about nhi-cql-validator

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

FAQPage Schema
How do I validate Taiwan NHI CQL files for regulatory compliance?

To validate Taiwan NHI CQL files, you submit .cql files for syntax, format, and business-logic checks against official NHI rules. This validation verifies structural correctness and regulatory compliance, generating coverage reports to ensure your CQL libraries meet standards.

What is FHIR ValueSet validation and how does it work with CQL?

FHIR ValueSet validation verifies JSON ValueSet files for correct structure, URL usage, and code coverage against NHI rules. When used with CQL validation, it cross-checks ValueSets to ensure clinical logic references correct, compliant code sets for decision support.

Can I validate multiple CQL and ValueSet files in a single batch?

Yes, you can validate multiple CQL and ValueSet files in a single batch. By pointing the validator to a directory, it processes all specified .cql and .json files together, streamlining quality assurance for CQL-based decision support across your project.

Does the CQL validator support auto-fix for formatting issues?

Yes, the CQL validator supports auto-fix for formatting issues and placeholders when explicitly requested. This optional feature automatically corrects syntax, indentation, and structural problems in your CQL libraries and ValueSet files on demand.

What are the limitations of automated NHI CQL validation?

A key limitation of automated NHI CQL validation is that auto-fix only applies to formatting issues or placeholders, not complex business logic. Business-logic validation requires comparing CQL against provided official NHI rules to assess coverage accurately.