solatis

incoherence

@solatis/incoherence
solatis
349
75 forks
Updated 1/6/2026
View on GitHub

Detect and resolve incoherence in documentation, code, specs vs implementation.

Installation

$skills install @solatis/incoherence
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathskills/incoherence/SKILL.md
Branchmain
Scoped Name@solatis/incoherence

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: incoherence description: Detect and resolve incoherence in documentation, code, specs vs implementation.

Incoherence Detector

When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.

Invocation

python3 scripts/incoherence.py \
  --step-number 1 \
  --total-steps 21 \
  --thoughts "<context>"
ArgumentRequiredDescription
--step-numberYesCurrent step (1-21)
--total-stepsYesAlways 21
--thoughtsYesAccumulated state from all previous steps

Do NOT explore or detect first. Run the script and follow its output.

Workflow Phases

  1. Detection (steps 1-12): Survey codebase, explore dimensions, verify candidates
  2. Resolution (steps 13-15): Present issues via AskUserQuestion, collect user decisions
  3. Application (steps 16-21): Apply resolutions, present final report

Resolution is interactive - user answers structured questions inline. No manual file editing required.