upgrade-codeql-cli-and-packs

Upgrade CodeQL CLI versions and synchronize ql-mcp-* packs across dependencies.

30|3|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/advanced-security/codeql-development-mcp-server --skill upgrade-codeql-cli-and-packs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade-codeql-cli-and-packs
Source: https://github.com/advanced-security/codeql-development-mcp-server/tree/main/.github/skills/upgrade-codeql-cli-and-packs
Command: npx skills add https://github.com/advanced-security/codeql-development-mcp-server --skill upgrade-codeql-cli-and-packs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps CodeQL CLI and MCP packs in sync whenever a new CodeQL CLI is released, preventing compatibility issues during development and deployment.

Core Features & Use Cases

  • Phase-aligned upgrades: updates .codeql-version, all package.json files, and ql-mcp-* pack versions to maintain alignment.
  • Compatibility validation: ensures extractor dbscheme in codeql packs matches the libraries used by queries.
  • End-to-end workflow: provides a deterministic upgrade path, tests, and rollback guidance.

Quick Start

Run the upgrade workflow to align the CodeQL CLI version and synchronize all ql-mcp-* packs and verify compatibility with the verification script.

Frequently Asked Questions about upgrade-codeql-cli-and-packs

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

FAQPage Schema
How do I upgrade the CodeQL CLI and keep ql-mcp-* packs synchronized?

To upgrade the CodeQL CLI and synchronize ql-mcp-* packs, run the provided workflow to align .codeql-version, package.json files, and codeql/*-all dependencies automatically.

What does CodeQL dbscheme compatibility validation check during a CLI release?

CodeQL dbscheme compatibility validation checks that the extractor dbscheme in codeql packs matches the libraries used by queries before release. This prevents compatibility issues during development and deployment.

Why do my CodeQL packs break after updating the CLI version?

CodeQL packs break after a CLI update due to version misalignment between .codeql-version, package.json, and codeql/*-all dependencies. Synchronizing all ql-mcp-* packs resolves this.

Can I automate CodeQL CLI version alignment across multiple package.json files?

Yes, you can automate CodeQL CLI version alignment across multiple package.json files. The workflow updates .codeql-version and all ql-mcp-* pack versions deterministically to maintain alignment.

What is the best way to roll back a failed CodeQL CLI and pack upgrade?

The best way to roll back a failed CodeQL CLI and pack upgrade is to follow the workflow's rollback guidance after running the verification script to identify compatibility failures.

When do I need to align ql-mcp-* pack versions with a new CodeQL CLI?

You need to align ql-mcp-* pack versions with a new CodeQL CLI whenever a new version is released and the MCP server's packs across languages require alignment for continued compatibility.