# Incoherence

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

- Skill: `solatis/incoherence` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add solatis/incoherence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/solatis/incoherence/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: solatis (https://skillmd.com/u/solatis)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/solatis/incoherence

---


# Incoherence Detector

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

## Invocation

<invoke working-dir=".claude/skills/scripts" cmd="python3 -m skills.incoherence.incoherence --step-number 1 --thoughts '<context>'" />

| Argument        | Required | Description                               |
| --------------- | -------- | ----------------------------------------- |
| `--step-number` | Yes      | Current step (starts at 1)                |
| `--thoughts`    | Yes      | Accumulated 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.