cqs-diff

Compare indexed code snapshots to identify added, removed, and modified functions.

13|3|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/jamie8johnson/cqs --skill cqs-diff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cqs-diff
Source: https://github.com/jamie8johnson/cqs/tree/main/.claude/skills/cqs-diff
Command: npx skills add https://github.com/jamie8johnson/cqs --skill cqs-diff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzing changes between two code snapshots can be error-prone and time-consuming; this Skill provides a precise semantic diff between indexed snapshots to show what changed.

Core Features & Use Cases

  • Semantic diff: Identify added, removed, and modified functions between two indexed snapshots.
  • Reference-based workflow: Compare a source reference against an optional target reference (default: project) to track evolution across versions or branches.
  • Usage scenarios: Use to audit changes before merging or to track regressions across releases.

Quick Start

Run the cqs_diff tool to compare two indexed snapshots and show additions, deletions, and modifications.

Frequently Asked Questions about cqs-diff

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

FAQPage Schema
How do I compare two code snapshots to find modified functions?

To compare two code snapshots and find modified functions, you can run a semantic diff tool that identifies added, removed, and modified functions between indexed source and target references.

What is a semantic diff and how does it work?

A semantic diff analyzes changes between indexed code snapshots by comparing functions rather than raw text, classifying additions, deletions, and modifications based on a configurable similarity threshold.

Do I need to configure references before comparing code snapshots?

Yes, you must configure references using a reference management command before comparing code snapshots, establishing the source and optional target references needed to execute the semantic diff.

Can I scope semantic diff results to a specific programming language?

Yes, you can apply an optional language filter when running the semantic diff to scope the results and focus specifically on functions written in that targeted programming language.

How do I track code regressions across different release versions?

You can track code regressions across releases by comparing a source reference against a target reference, allowing you to audit function modifications and deletions before merging branches or deploying versions.

How does the similarity threshold affect code change classification?

The configurable similarity threshold determines how functions are classified during the semantic diff, establishing the boundary that distinguishes a modified function from an entirely removed and newly added one.