# Randlee Synaptic Canvas Sc Diff

> sc-diff

- Skill: `tomevault-io/randlee-synaptic-canvas-sc-diff` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/randlee-synaptic-canvas-sc-diff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/randlee-synaptic-canvas-sc-diff/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/randlee-synaptic-canvas-sc-diff

---


# sc-diff

## Capabilities
- Compare two files or two folders (exactly one of each per request)
- Auto semantic diff for .cs/.vb with line fallback for non-.NET files
- JSON-first output for AI consumption
- Optional HTML report per pair
- Git/PR-based comparisons via sc-git-diff
- Smart batching for large diff sets

## Agent Delegation
| Operation | Agent | Returns |
|-----------|-------|---------|
| File/folder diff | `sc-diff` | JSON: results[], counts, warnings |
| Git/PR diff | `sc-git-diff` | JSON: results[], refs, counts |

Invoke agents via Agent Runner using `.claude/agents/registry.yaml`.

## Parameters
- `files`: string (comma-delimited list of 2 file paths)
- `folders`: string (comma-delimited list of 2 folder paths)
- `html`: boolean (default false)
- `mode`: `auto` (default), `roslyn`, `line`
- `ignore_whitespace`: boolean (default false)
- `context_lines`: number (optional, default 3)
- `text_output`: string|bool (optional; true writes `.sc/roslyn-diff/temp/diff-#.txt`)
- `git_output`: string|bool (optional; true writes `.sc/roslyn-diff/temp/diff-#.patch`)
- `allow_large`: boolean (default false)
- `files_per_agent`: number (default 10)
- `max_pairs`: number (default 100)
- `git_pr`: string (PR URL or PR number)

## Behavior
1) Validate exactly one of `files` or `folders`.
2) Resolve inputs into file pairs.
3) If pair count > `max_pairs` and `allow_large` is false, stop with a warning.
4) If pair count > `files_per_agent`, split into batches and spawn sub-agents.
5) Aggregate results: include non-identical diffs and counts.

## Caching
- Cache Azure DevOps org/project/repo in `.sc/roslyn-diff/settings.json`.
- Store defaults like `files_per_agent` when set explicitly.

## Output Contract
- Always return fenced JSON with a discriminated union: `success: true|false`.
- `success: true` includes aggregated counts and per-pair roslyn-diff JSON outputs.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/randlee) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->