Kodex Fix

Fix flagged Kodex topics by generating updated content.

Overview

This skill lists open Kodex flags and routes to the appropriate sub-skill based on flag type. After the sub-skill creates a draft, the user can review and approve it in the Kodex UI.

Use when:

• You see open flags in the Kodex dashboard
• A topic has been flagged as outdated, incorrect, incomplete, or missing

---

Step 1: List Open Flags

Query for open flags:

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_list_flags
Args: { "project": "<absolute-path-to-cwd>", "status": "open" }

If no open flags:

No open flags to fix.

Use the Kodex dashboard to view all flags or /kodex-init to create new topics.

STOP - exit the skill.

---

Step 2: Select Flag

Present flags to user:

Open flags:

1. [outdated] topic-name: Description of the issue
2. [incorrect] another-topic: Description of the issue
3. [missing] new-topic: Description of the issue

Which flag do you want to fix?

Use AskUserQuestion with multiple choice.

---

Step 3: Route to Sub-Skill

Based on the selected flag's type:

| Flag Type | Sub-Skill | |-----------|-----------| | outdated | Invoke skill: kodex-fix-outdated | | incorrect | Invoke skill: kodex-fix-incorrect | | incomplete | Invoke skill: kodex-fix-incomplete | | missing | Invoke skill: kodex-fix-missing |

Pass the topic name and flag description to the sub-skill.

---

Step 4: Completion

After sub-skill returns:

Draft created for [topic-name].

Review and approve the draft in the Kodex UI:
- Go to Kodex > Drafts
- Review the content
- Click "Approve" to publish (this will auto-resolve the flag)

Fix another flag?

1. Yes
2. No

If user selects 1 (Yes): Return to Step 1 If user selects 2 (No): Exit skill

---

Error Handling

| Error | Action | |-------|--------| | MCP tool failure | Display error, suggest retry | | Flag not found | Refresh list, flag may have been resolved |

---

Integration

Standalone skill - Does not require an active collab session.

Related skills:

• kodex-fix-outdated - Update stale content
• kodex-fix-incorrect - Fix factual errors
• kodex-fix-incomplete - Fill missing sections
• kodex-fix-missing - Create new topics
• using-kodex - Query and flag topics
• kodex-init - Bootstrap topic stubs