Agent-Skills.md

Agent Skills: Incoherence Detector

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

UncategorizedID: solatis/claude-config/incoherence

Repository

solatis/claude-config
solatisLicense: MIT
44387

Skill Files

Browse the full folder contents for incoherence.

Download Skill

Loading file tree…

skills/incoherence/SKILL.md

Skill Metadata

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

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

| Argument | Required | Description | | --------------- | -------- | ----------------------------------------- | | --step-number | Yes | Current step (1-21) | | --total-steps | Yes | Always 21 | | --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.