incoherence
A script-driven tool to identify and fix contradictions between code, specs, and documentation.
Install
mkdir -p .claude/skills/incoherence && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/8677" && unzip -o skill.zip -d .claude/skills/incoherence && rm skill.zipInstalls to .claude/skills/incoherence
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Detect and resolve incoherence in documentation, code, specs vs implementation.Key capabilities
- →Survey codebase dimensions
- →Verify candidate inconsistencies
- →Collect user decisions for resolution
- →Apply automated resolutions
- →Generate final incoherence report
How it works
The skill executes a diagnostic script that surveys the project and guides the user through an interactive resolution process.
Inputs & outputs
When to use incoherence
- →Syncing documentation with code
- →Identifying specification drift
- →Resolving logic contradictions
About this skill
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
- Detection (steps 1-12): Survey codebase, explore dimensions, verify candidates
- Resolution (steps 13-15): Present issues via AskUserQuestion, collect user decisions
- Application (steps 16-21): Apply resolutions, present final report
Resolution is interactive - user answers structured questions inline. No manual file editing required.
When not to use it
- →When manual file editing is preferred over interactive resolution
Limitations
- →Requires execution of the provided script
- →Resolution is interactive
How it compares
It uses an automated, interactive script-based workflow instead of manual cross-referencing.
Compared to similar skills
incoherence side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| incoherence (this skill) | 0 | 6mo | No flags | Advanced |
| deepwiki-rs | 25 | 9mo | Review | Intermediate |
| python-code-style | 9 | 6mo | Review | Intermediate |
| code-review-excellence | 19 | 5mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by solatis
View all by solatis →You might also like
deepwiki-rs
sopaco
AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation. Use when Claude needs to analyze source code, understand software architecture, generate technical specs, or create professional documentation from any programming language.
python-code-style
wshobson
Python code style, linting, formatting, naming conventions, and documentation standards. Use when writing new code, reviewing style, configuring linters, writing docstrings, or establishing project standards.
code-review-excellence
wshobson
Master effective code review practices to provide constructive feedback, catch bugs early, and foster knowledge sharing while maintaining team morale. Use when reviewing pull requests, establishing review standards, or mentoring developers.
code-walk-thru
pchalasani
Use this when user wants you to walk through (code or text) files in a EDITOR to either explain how some code works, or to show the user what changes you made, etc. You would typically use this repeatedly to show the user your changes or code files one by one, sometimes with specific line-numbers. This way the user is easily able to follow along in their favorite EDITOR as you point at various files possibly at specific line numbers within those files.
cookbook-audit
anthropics
Audit an Anthropic Cookbook notebook based on a rubric. Use whenever a notebook review or audit is requested.
schema-markup
davila7
When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," or "breadcrumb schema." For broader SEO issues, see seo-audit.