Back to Skills

kodex-fix-incorrect

verified

Correct factually incorrect Kodex topic content

View on GitHub

Marketplace

mermaid-collab-dev

ben-mad-jlp/claude-mermaid-collab

Plugin

mermaid-collab

Repository

ben-mad-jlp/claude-mermaid-collab

skills/kodex-fix-incorrect/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
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-incorrect

Installation paths:

Claude
.claude/skills/kodex-fix-incorrect/
Powered by add-skill CLI

Instructions

# 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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3461 chars