kajisho5/ffmpeg-skill / .claude/skills/sibling-sweep
sweeping-defect-siblings
VerifiedTurn one reported defect in ffmpeg-skill into the full list of places the same thing happens — naming the defect's class (an input property, a shared step, a convention that differs between two code paths, an FFmpeg-version behaviour), sweeping every tool with tests/sweep.py and a path-parity probe, separating decided refusals from real siblings, and landing the fix with one regression test per class rather than per report. Use whenever an issue or PR comment reports a bug in this repository, before writing the fix, and again when triaging an external review or audit.
Sweeping Defect Siblings
A report from outside names one tool and one input. It is almost never the only
place the defect lives, and the reporter found it because nobody inside thought
to look. #437 named insert.py and an odd-sized JPEG; the same odd frame also
broke caption.py and crashed stabilize.py on a video, which nobody had
reported. #436 named --position top; the documented example in --help used
that exact flag and had never worked.
So a fix for the reported line is half the job. The other half is the sweep, and it happens before the fix is written, because the siblings decide where the fix belongs (one shared helper, or one tool).
The loop
-
Reproduce the report as written, on the local FFmpeg. If it does not reproduce, check the fixture before the tool: FFmpeg sources round sizes, drop tags and pick pixel formats on their own (the
colorsource turns 629x1400 into 628x1400 for 4:2:0). Build the input another way and assert its properties withprobe.pyfirst. -
Name the class. Write one sentence that does not mention the reported tool. The usual classes here:
Class The sentence looks like Sweep with Input property "a frame with an odd width reaches a filter that refuses it" tests/sweep.py INPUT --baseline PLAINShared step "the BT.601 conversion is first in every graph" grep the helper's callers, then the sweep Two paths, one meaning " --srtand--textreach libass by different routes"run both paths with every value of the flag and compare the measurement Convention mismatch "a number means something else to the library" grep every place that number family is written Version behaviour "from 7.1 the encoder takes tags from frames" the CI job logs for 6.1 / 7.1 / 8 / 9, and the fixtures that set the same thing Result claim " verified: truewith something missing"the sweep's verified,warningsanddroppedcolumns -
Sweep.
python3 tests/sweep.py INPUT --baseline PLAINprints only the tools whose result differs from a plain clip's. Vary the property, not only the tool: if the report is an odd JPEG, also try an odd PNG, an odd video, an odd size in each of width and height. For a flag, run every choice of the flag, not the one reported. -
Sort the rows. For each differing row, read
docs/design-decisions.md:- a refusal with
kind: inputand a hint that names the way out is usually a decision: leave it, and say in the PR that it was seen; kind: ffmpeg, an assertion, "Nothing was written", or a completed run whose output is wrong is a sibling.
A row that matches the baseline proves less than it looks: the sweep compares what each tool said, and deletes what it wrote. A defect in the pixels or the sound with an honest-looking result (the #436 kind:
completed,verified: true, text in the wrong place) leaves every row equal. When the class is "the output is wrong" rather than "the run fails", run the tools the class can reach yourself and measure the output (a bounding box, a frame hash,check.py --compare, a loudness reading), matching rows included. - a refusal with
-
Decide where the fix goes. Two or more siblings through one helper: fix the helper. Siblings with separate causes: fix the reported one here and file the others in one issue titled by the class, with the sweep rows pasted in.
-
Pin the class, not the report. The regression test iterates the property (all seven positions, both odd axes, both paths), and asserts the fixture before the tool.
-
Say what was swept in the PR body under "Siblings": the class sentence, the command, the rows that differed, and which were fixed, filed or decided. "None found" needs the command that found none.
What a sweep is not
- Not a reason to widen the PR without limit: siblings with their own cause go to an issue.
- Not a judgement:
tests/sweep.pyprints what each tool said. A row is a question for design-decisions, not a bug by itself. - Not complete: the table covers tools that take one media file. Sweep
join,sync,multicam,broll,render,batch,sequence,grid,insert,reportandbackgroundby hand when the class can reach them.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |