Kodex Fix Incomplete

Fill in missing sections of incomplete Kodex topics.

Overview

This sub-skill is invoked by

kodex-fix

when a topic is flagged as incomplete. It identifies which sections are empty or sparse and fills them in.

---

Step 1: Get Existing Topic

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_query_topic
Args: { "project": "<cwd>", "name": "<topic-name>" }

Identify which sections need content:

• conceptual: Empty or just placeholder text?
• technical: Empty or lacks detail?
• files: Missing file list?
• related: Missing related topics?

---

Step 2: Gather Information for Missing Sections

For each empty/sparse section:

conceptual (if empty):

• Read main entry points
• Check for README in component directory
• Summarize purpose from code comments

technical (if empty):

• Analyze implementation patterns
• Document key functions and their purposes
• Note any gotchas or important details

files (if empty):

Tool: Glob
Args: { "pattern": "**/*<topic-keyword>*" }

related (if empty):

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_list_topics
Args: { "project": "<cwd>" }

Find topics with related names or overlapping file paths.

---

Step 3: Generate Content for Missing Sections

Only fill empty/sparse sections. Preserve existing content.

---

Step 4: Validate with User

For each filled section:

**[Section name] (new content):**
[generated content]

Does this accurately describe [topic]?
1. Yes
2. No - needs changes

---

Step 5: Create Draft

Tool: mcp__plugin_mermaid-collab_mermaid__kodex_update_topic
Args: {
  "project": "<cwd>",
  "name": "<topic-name>",
  "content": { ... },
  "reason": "Filled incomplete sections: [list sections]"
}

Return to parent skill.

---

Integration

Called by: kodex-fix (parent skill) Returns to: kodex-fix after creating draft