Agent-Skills.md

Agent Skills: Incoherence Detector

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

code-reviewdocumentationspecification-documentsquality-management
reviewID: solatis/claude-config/incoherence

Repository

solatis/claude-config
solatis

Install this agent skill to your local

pnpm dlx add-skill https://github.com/solatis/claude-config/tree/HEAD/skills/incoherence

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 --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.