Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

kodex-generate-aliases

verified

Use when generating aliases for Kodex topics to improve findability and search coverage

View on GitHub

Marketplace

mermaid-collab-dev

ben-mad-jlp/claude-mermaid-collab

Plugin

mermaid-collab

Repository

ben-mad-jlp/claude-mermaid-collab
2stars

skills/kodex-generate-aliases/SKILL.md

Last Verified

February 3, 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-generate-aliases/SKILL.md -a claude-code --skill kodex-generate-aliases

Installation paths:

Claude
.claude/skills/kodex-generate-aliases/
Powered by add-skill CLI

Instructions

# 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

Validation Details

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