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.