change-classification

Classify changed files into in-context, uncertain, or out-of-context categories.

6|2|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/synaptiai/synapti-marketplace --skill change-classification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-classification
Source: https://github.com/synaptiai/synapti-marketplace/tree/main/plugins/flow/skills/change-classification
Command: npx skills add https://github.com/synaptiai/synapti-marketplace --skill change-classification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents accidental, out-of-context, or unsafe changes from being committed by classifying every changed file as in-context, uncertain, or out-of-context and flagging secrets, large additions, and red-flag patterns before staging or committing.

Core Features & Use Cases

  • Signal-based classification: Uses primary signals from branch diffs and issue/task context and secondary signals like sibling changes and test associations to determine relevance.
  • Safety and red flags: Detects secret patterns, large binaries, lockfile changes, and auto-generated files and enforces blocking or warning actions for critical patterns.
  • Review focus and grouping: Identifies first-touch files and groups in-context changes into atomic commits by logical unit, type, or directory to improve review quality.
  • Use Case: During a feature branch commit, run classification to automatically surface files that are unrelated to the issue, highlight first-touch additions for extra review, and produce atomic commit suggestions.

Quick Start

Classify all changed files and display a table showing file-level classifications and signals before staging or committing.

Frequently Asked Questions about change-classification

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

FAQPage Schema
How do I prevent unrelated files from being included in a git commit?

To prevent out-of-context commits, this Skill evaluates git diffs and issue context to classify changed files, flagging unrelated directory edits and grouping in-context changes into atomic commits.

What is atomic commit grouping in code review workflows?

Atomic commit grouping in code review workflows is the process of organizing in-context file changes into logical units by type or directory. This classification improves review focus by separating relevant modifications from uncertain or out-of-context files.

How do I detect secrets and large binaries in a git diff before staging?

To detect secrets and large binaries in a git diff, the classification process analyzes filename and pattern signals alongside change size heuristics. It enforces warning or blocking actions when critical patterns like secrets or large additions are found.

Can I flag first-touch files for extra review during a pre-PR check?

Yes, you can flag first-touch files during a pre-PR check by evaluating filename and pattern signals. The classification identifies these new additions and highlights them in a classification table to ensure they receive extra review focus.

Does this code classification approach work with lockfile and auto-generated file changes?

Yes, this code classification approach works with lockfile and auto-generated file changes by using secondary signals like sibling changes to evaluate their relevance. It specifically detects these file patterns and classifies them appropriately to prevent unnecessary review overhead.

When should I use automated file classification instead of manual code review?

You should use automated file classification instead of manual code review when you need to quickly surface out-of-context modifications, detect secret patterns, and group atomic commits. It serves as a first-touch filter to improve review quality before staging or committing.