agentleFS
JiamingShi-JsPhysJiamingShi-JsPhys/chelate-shell/skills/conflict-detector/SKILL.md

conflict-detector

Skill10 starsChanged 6 days agoMITView on GitHub

Cross-checks two or more documents, datasets or extracted fact tables for contradictions and reports each conflict with a severity. Numbers are compared with hard cross-checks, not fuzzy inference.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run this exact form — do not read the source tree:

    line 26
  2. Distinctive:

    Only one document is involved — there is nothing to cross-check.

    line 44
  3. Distinctive:

    No conflicts found is a success with an empty report.

    line 69

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

conflict-detector

Finds claims that disagree across sources and grades them by level: entity (numeric/boolean), clause (categorical), argument (free text). It reports conflicts; it does not decide which source is right.

  • Stage: gates · Sandbox: no · Dependencies: stdlib only (PyYAML only for .yaml configs)

Quick Execution

Run this exact form — do not read the source tree:

python run.py --root <WS> --action run -- --config config/examples/two_docs.yaml
  • validate first: it is fast and writes no report.
  • --format json,csv,md selects the output formats (default: json).
  • The gate lands in <WS>/process/gates/conflict-detector_<ts>.json.

When to use

  • Two or more sources must be checked against each other.
  • A single claim appears in several places and their agreement matters.
  • An extracted fact table must be audited for internal contradictions.

When NOT to use

  • Only one document is involved — there is nothing to cross-check.
  • You need a correctness judgement rather than a consistency report.

Actions

--actionDoesExtra arguments
validateCheck the config, no report written--config <cfg>
list-docsList the sources a config resolves to--config <cfg>
runDetect conflicts--config <cfg> [--format json,csv,md]

Hard constraints

  • Never invent a conflict. An empty report is a valid result.
  • Report severity as computed, never re-graded by hand.

Outputs

  • <WS>/process/gates/conflict-detector_<ts>.json — the gate result.
  • The conflict report in the requested formats under process/.

Failure handling

  • An invalid config exits non-zero and names the field.
  • An unreachable source aborts the run naming that source.
  • No conflicts found is a success with an empty report.

Limitations

  • Extraction is key-value oriented; free-text paragraphs only participate at the argument level.
  • Unit normalisation is table-driven (unit_map); custom units must be declared.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.