check-querypack-deprecations

Detect deprecated resource and field references in MQL query pack YAML files.

407|38|Updated Aug 16, 2022

Search Tags:#static analysis #yaml #mql #query packs #deprecation audit #schema compatibility #provider resources

Ready to run

npx skills add https://github.com/mondoohq/mql --skill check-querypack-deprecations

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: check-querypack-deprecations
Source: https://github.com/mondoohq/mql/tree/main/.claude/skills/check-querypack-deprecations
Command: npx skills add https://github.com/mondoohq/mql --skill check-querypack-deprecations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify outdated or deprecated resource or field references inside MQL query pack files so your queries stay compatible with evolving provider definitions.

Core Features & Use Cases

Detect deprecated resources and fields: Scans providers/*/resources/*.lr for entries marked as deprecated and derives replacements.
Audit query pack files: Checks content/*.mql.yaml (or a single specified file) for deprecated resource/field usage within mql: query blocks.
Produce actionable reports: Outputs a markdown table with the file path, query UID, exact deprecated text found, and the suggested replacement.
Read-only safety: Does not modify any files; it only reports findings.

Quick Start

Use check-querypack-deprecations to scan all MQL query pack files for deprecated resource or field references and list every match with recommended replacements.

Frequently Asked Questions about check-querypack-deprecations

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

FAQPage Schema

How do I find deprecated resource references in MQL query pack YAML files?▼

To find deprecated resource references in MQL query pack YAML files, scan the content/*.mql.yaml path to extract exact matches of outdated fields and cross-reference them against provider .lr definitions marked as Deprecated.

What is a query pack deprecation audit and when do I need to run one?▼

A query pack deprecation audit identifies outdated resource or field references inside MQL files so your queries remain compatible with evolving provider schemas. You need to run it during maintenance or upgrade workflows before executing queries against current infrastructure models.

How do I generate a report of deprecated fields in query packs?▼

Generate a report of deprecated fields by scanning the providers/*/resources/*.lr directory for deprecation markers and extracting matches from mql: query blocks. The output is a markdown table listing the file path, query UID, deprecated text, and suggested replacement.

Does the query pack deprecation scanner modify my YAML files?▼

No, the query pack deprecation scanner operates with read-only safety and does not modify any files. It only reports findings by extracting deprecated replacements and listing exact matches in a markdown table.

Can I scan a single MQL query pack file instead of the entire content directory?▼

Yes, you can scan a single specified MQL query pack file instead of the entire content/*.mql.yaml directory. The scanner will extract deprecated resource and field usage from the mql: query blocks within that specific file.

How do I update query packs for schema compatibility before an infrastructure upgrade?▼

To update query packs for schema compatibility before an infrastructure upgrade, scan the YAML files to cross-reference deprecated provider .lr definitions and report exact matches with suggested replacements, ensuring your queries align with current infrastructure models.