Correct factually incorrect Kodex topic content
View on GitHubben-mad-jlp/claude-mermaid-collab
mermaid-collab
skills/kodex-fix-incorrect/SKILL.md
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/ben-mad-jlp/claude-mermaid-collab/blob/main/skills/kodex-fix-incorrect/SKILL.md -a claude-code --skill kodex-fix-incorrectInstallation paths:
.claude/skills/kodex-fix-incorrect/# Kodex Fix Incorrect
Correct factually incorrect Kodex topic content.
## Overview
This sub-skill is invoked by `kodex-fix` when a topic is flagged as incorrect. It focuses on the specific inaccuracy described in the flag and verifies against actual code.
---
## Step 1: Get Existing Topic and Flag Details
Query the existing topic to understand the current content:
```
Tool: mcp__plugin_mermaid-collab_mermaid__kodex_query_topic
Args: { "project": "<cwd>", "name": "<topic-name>" }
```
Review the flag description to understand what's incorrect. Extract:
- Current content (conceptual, technical, files, related)
- File paths from the 'files' section
- The specific inaccuracy mentioned in the flag
**If topic not found:**
```
Topic not found. This may need kodex-fix-missing instead.
```
Return to parent skill.
---
## Step 2: Verify the Inaccuracy
Focus on the specific inaccuracy mentioned in the flag. Read the files mentioned in the topic to compare what they actually contain versus what the topic claims:
```
Tool: Read
Args: { "file_path": "<file-from-topic>" }
```
Compare:
- What the topic claims
- What the code actually does
Identify the specific incorrect statement(s) by examining the implementation. Focus specifically on the inaccuracy flagged rather than a general review.
---
## Step 3: Research Correct Information
Use Grep to find actual implementations and verify what the code actually does:
```
Tool: Grep
Args: { "pattern": "<function-or-concept>", "path": "<project-root>" }
```
Build accurate understanding of how things actually work in the codebase. Research the specific behavior that contradicts what the topic currently documents.
---
## Step 4: Generate Corrected Content
Update the sections that contain the inaccuracy. Focus corrections on:
- The specific inaccuracy from the flag
- Any related incorrect statements discovered during research
- Keep accurate parts unchanged
Generate corrected versions of affected sections (conceptual, tec