Use when generating aliases for Kodex topics to improve findability and search coverage
View on GitHubskills/kodex-generate-aliases/SKILL.md
February 3, 2026
Select agents to install to:
npx add-skill https://github.com/ben-mad-jlp/claude-mermaid-collab/blob/main/skills/kodex-generate-aliases/SKILL.md -a claude-code --skill kodex-generate-aliasesInstallation paths:
.claude/skills/kodex-generate-aliases/# Generate Aliases for Kodex Topic ## Overview Kodex topics can only be found by exact name match. This skill automates alias generation to make topics discoverable through synonyms, abbreviations, and related terms. Generate aliases for a topic and approve additions in one workflow. **Core principle:** Good aliases expand discoverability without cluttering the knowledge base. ## When to Use - Adding multiple aliases to an existing topic manually is tedious - You want to quickly generate relevant search terms for a topic - You need to improve topic findability without renaming it - Batch-generating aliases across multiple topics **When NOT to use:** - Manual alias management for 1-2 topics (use the UI directly) - Fixing incorrect generated aliases (edit them individually in UI) ## Quick Reference **Invoke the skill:** ``` /kodex-generate-aliases topic-name ``` **What happens:** 1. Load topic and display current aliases 2. Generate new aliases from title, synonyms, abbreviations, content 3. Show generated aliases for approval 4. Add confirmed aliases to topic **Aliases come from 4 sources:** | Source | Example | |--------|---------| | **Title keywords** | Topic "debugging-with-logs" → "debugging", "logs" | | **Synonyms** | "db" → "database", "storage", "data" | | **Abbreviations** | "configuration" → "config" | | **Content keywords** | Most-used words from topic content | ## Workflow ### Step 1: Select Topic Provide a topic name. The skill loads the full topic with content. **Input format:** `/kodex-generate-aliases topic-name` **Error handling:** - Topic not found: "Topic 'xyz' not found. Check name and try again." - Topic without title: Use topic name as fallback ### Step 2: Generate Aliases The skill calls the `generateAliases()` function with: - Topic name (canonical identifier) - Topic title (for keyword extraction) - Topic content (for keyword frequency analysis) **Generation rules:** - Extract keywords from title (words > 2 chars) - Expand wi