codex-skills-mcp 1.0.0

package/dist/loader/index.js

@@ -0,0 +1,246 @@
+import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
+import { resolve, join, relative, extname } from "node:path";
+import { ensureSkillFetched } from "../remote/github.js";
+// Files/dirs to skip when scanning structure
+const SKIP_NAMES = new Set([
+    "node_modules", ".git", ".github", "__pycache__",
+    ".DS_Store", ".env", ".venv", "venv",
+    "dist", "build", ".next", ".cache",
+]);
+// Max file size to return via load_skill_file (500KB)
+const MAX_FILE_SIZE = 500 * 1024;
+/**
+ * Skill loader — reads SKILL.md, scans structure, detects dependencies.
+ */
+export class SkillLoader {
+    config;
+    manifest;
+    skillsDir;
+    constructor(config, manifest) {
+        this.config = config;
+        this.manifest = manifest;
+        this.skillsDir = config.skillsDir;
+    }
+    /**
+     * Resolve the absolute filesystem path for a skill.
+     */
+    resolveSkillPath(entry) {
+        // relative_path starts with "./" and is relative to the manifest dir
+        const relPath = entry.relative_path.replace(/^\.\//, "");
+        return resolve(this.skillsDir, relPath);
+    }
+    /**
+     * Read a skill's SKILL.md + structure + dependencies.
+     */
+    async readSkill(entry) {
+        if (this.config.isRemote) {
+            await ensureSkillFetched(this.config, entry);
+        }
+        const skillPath = this.resolveSkillPath(entry);
+        // Read SKILL.md
+        let instructions = "";
+        const skillMdPath = join(skillPath, "SKILL.md");
+        if (existsSync(skillMdPath)) {
+            instructions = readFileSync(skillMdPath, "utf-8");
+        }
+        else {
+            instructions = `[No SKILL.md found for ${entry.name}]\n\nDescription: ${entry.description}`;
+        }
+        // Scan structure
+        const structure = this.scanStructure(skillPath, entry);
+        // Detect dependencies
+        const dependencies = this.detectDependencies(skillPath);
+        return { instructions, structure, dependencies };
+    }
+    /**
+     * Scan the file tree of a skill (max depth 2 by default).
+     */
+    scanStructure(dirPath, entry, maxDepth = 2) {
+        const files = this.scanDirectory(dirPath, 0, maxDepth);
+        // Find sub-skills: look for nested SKILL.md files
+        const subSkills = [];
+        this.findSubSkills(dirPath, dirPath, subSkills);
+        return { files, sub_skills: subSkills };
+    }
+    scanDirectory(dirPath, currentDepth, maxDepth) {
+        if (!existsSync(dirPath))
+            return [];
+        const nodes = [];
+        try {
+            const entries = readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (SKIP_NAMES.has(entry.name))
+                    continue;
+                if (entry.name.startsWith(".") && entry.name !== ".env.example")
+                    continue;
+                const fullPath = join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    const node = {
+                        name: entry.name,
+                        type: "directory",
+                    };
+                    if (currentDepth < maxDepth) {
+                        node.children = this.scanDirectory(fullPath, currentDepth + 1, maxDepth);
+                    }
+                    nodes.push(node);
+                }
+                else if (entry.isFile()) {
+                    try {
+                        const stat = statSync(fullPath);
+                        nodes.push({
+                            name: entry.name,
+                            type: "file",
+                            size_bytes: stat.size,
+                        });
+                    }
+                    catch {
+                        nodes.push({ name: entry.name, type: "file" });
+                    }
+                }
+            }
+        }
+        catch {
+            // Permission denied or other errors
+        }
+        return nodes;
+    }
+    /**
+     * Recursively find sub-skill SKILL.md files (not the root one).
+     */
+    findSubSkills(rootPath, currentPath, results, depth = 0) {
+        if (depth > 4)
+            return;
+        try {
+            const entries = readdirSync(currentPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                if (SKIP_NAMES.has(entry.name))
+                    continue;
+                const subDir = join(currentPath, entry.name);
+                const subSkillMd = join(subDir, "SKILL.md");
+                if (existsSync(subSkillMd)) {
+                    // Extract name from frontmatter or use folder name
+                    const content = readFileSync(subSkillMd, "utf-8");
+                    const nameMatch = content.match(/^---[\s\S]*?name:\s*(.+?)$/m);
+                    const descMatch = content.match(/^---[\s\S]*?description:\s*(.+?)$/m);
+                    results.push({
+                        name: nameMatch ? nameMatch[1].trim() : entry.name,
+                        path: relative(rootPath, subDir),
+                        description: descMatch ? descMatch[1].trim() : "",
+                    });
+                }
+                // Recurse deeper
+                this.findSubSkills(rootPath, subDir, results, depth + 1);
+            }
+        }
+        catch {
+            // Permission denied
+        }
+    }
+    /**
+     * Detect language and package manager from project files.
+     */
+    detectDependencies(skillPath) {
+        // Python
+        if (existsSync(join(skillPath, "requirements.txt"))) {
+            return {
+                language: "python",
+                package_manager: "pip",
+                setup_command: "pip install -r requirements.txt",
+            };
+        }
+        if (existsSync(join(skillPath, "pyproject.toml"))) {
+            if (existsSync(join(skillPath, "uv.lock"))) {
+                return {
+                    language: "python",
+                    package_manager: "uv",
+                    setup_command: "uv sync",
+                };
+            }
+            return {
+                language: "python",
+                package_manager: "pip",
+                setup_command: "pip install .",
+            };
+        }
+        // Node.js
+        if (existsSync(join(skillPath, "package.json"))) {
+            return {
+                language: "typescript/javascript",
+                package_manager: "npm",
+                setup_command: "npm install",
+            };
+        }
+        // Go
+        if (existsSync(join(skillPath, "go.mod"))) {
+            return {
+                language: "go",
+                package_manager: "go mod",
+                setup_command: "go mod download",
+            };
+        }
+        // Pure skill (no runtime dependencies)
+        return { language: "markdown-only" };
+    }
+    /**
+     * Load a specific file from within a skill directory.
+     */
+    async loadSkillFile(entry, filePath) {
+        if (this.config.isRemote) {
+            await ensureSkillFetched(this.config, entry);
+        }
+        const skillPath = this.resolveSkillPath(entry);
+        const fullPath = resolve(skillPath, filePath);
+        // Security: ensure the resolved path is within the skill directory
+        if (!fullPath.startsWith(skillPath)) {
+            throw new Error("Path traversal detected: file must be within skill directory");
+        }
+        if (!existsSync(fullPath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            throw new Error(`Path is a directory, not a file: ${filePath}`);
+        }
+        if (stat.size > MAX_FILE_SIZE) {
+            throw new Error(`File too large (${Math.round(stat.size / 1024)}KB). Max: ${MAX_FILE_SIZE / 1024}KB`);
+        }
+        // Check if binary
+        const ext = extname(fullPath).toLowerCase();
+        const binaryExts = new Set([
+            ".png", ".jpg", ".jpeg", ".gif", ".ico", ".webp",
+            ".woff", ".woff2", ".ttf", ".eot",
+            ".zip", ".7z", ".tar", ".gz",
+            ".exe", ".dll", ".so", ".dylib",
+            ".pdf", ".doc", ".docx",
+        ]);
+        if (binaryExts.has(ext)) {
+            return {
+                content: `[Binary file: ${filePath} (${stat.size} bytes)]`,
+                size_bytes: stat.size,
+            };
+        }
+        const content = readFileSync(fullPath, "utf-8");
+        return { content, size_bytes: stat.size };
+    }
+    /**
+     * List files in a subdirectory of a skill.
+     */
+    async listSkillFiles(entry, subPath = "", maxDepth = 2) {
+        if (this.config.isRemote) {
+            await ensureSkillFetched(this.config, entry);
+        }
+        const skillPath = this.resolveSkillPath(entry);
+        const targetPath = subPath ? resolve(skillPath, subPath) : skillPath;
+        // Security check
+        if (!targetPath.startsWith(skillPath)) {
+            throw new Error("Path traversal detected");
+        }
+        if (!existsSync(targetPath)) {
+            throw new Error(`Path not found: ${subPath || "."}`);
+        }
+        return this.scanDirectory(targetPath, 0, maxDepth);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/loader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"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"}

package/dist/remote/github.d.ts

@@ -0,0 +1,14 @@
+import type { Config, ManifestEntry } from "../config.js";
+/**
+ * Initialize remote caching by fetching the repository tree
+ */
+export declare function initRemote(config: Config): Promise<void>;
+/**
+ * Download the manifest file
+ */
+export declare function fetchManifest(config: Config): Promise<void>;
+/**
+ * Ensure a skill's directory is downloaded and cached
+ */
+export declare function ensureSkillFetched(config: Config, entry: ManifestEntry): Promise<void>;
+//# sourceMappingURL=github.d.ts.map

package/dist/remote/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/remote/github.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiC1D;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB9D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD5F"}

package/dist/remote/github.js

@@ -0,0 +1,90 @@
+import { writeFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+/**
+ * Fetch with optional auth token
+ */
+async function fetchWithAuth(url, token) {
+    const headers = {};
+    if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
+    }
+    return res;
+}
+/**
+ * Initialize remote caching by fetching the repository tree
+ */
+export async function initRemote(config) {
+    const treePath = resolve(config.skillsDir, "tree.json");
+    if (existsSync(treePath)) {
+        return; // Already initialized in this run
+    }
+    const url = `https://api.github.com/repos/${config.githubRepo}/git/trees/${config.githubBranch}?recursive=1`;
+    console.error(`[codex-skills-mcp] Fetching repo tree from ${url}...`);
+    const res = await fetchWithAuth(url, config.githubToken);
+    const data = (await res.json());
+    if (data.truncated) {
+        console.error("[codex-skills-mcp] Warning: GitHub tree is truncated, some files may be missing.");
+    }
+    writeFileSync(treePath, JSON.stringify(data.tree, null, 2), "utf-8");
+    console.error(`[codex-skills-mcp] Cached ${data.tree.length} tree items.`);
+}
+/**
+ * Download the manifest file
+ */
+export async function fetchManifest(config) {
+    if (existsSync(config.manifestPath))
+        return;
+    const rawUrl = `https://raw.githubusercontent.com/${config.githubRepo}/${config.githubBranch}/${config.githubPath}/skills_manifest.json`;
+    console.error(`[codex-skills-mcp] Fetching manifest from ${rawUrl}...`);
+    const res = await fetchWithAuth(rawUrl, config.githubToken);
+    const text = await res.text();
+    writeFileSync(config.manifestPath, text, "utf-8");
+}
+/**
+ * Ensure a skill's directory is downloaded and cached
+ */
+export async function ensureSkillFetched(config, entry) {
+    const relPath = entry.relative_path.replace(/^\.\//, "");
+    const skillLocalPath = resolve(config.skillsDir, relPath);
+    if (existsSync(skillLocalPath)) {
+        return; // Already fetched
+    }
+    const treePath = resolve(config.skillsDir, "tree.json");
+    if (!existsSync(treePath)) {
+        throw new Error("Tree cache not found, run initRemote first.");
+    }
+    const tree = JSON.parse(readFileSync(treePath, "utf-8"));
+    // The prefix in github is githubPath + relPath
+    // e.g. "codex-skills/01_代码工程与架构/planning-with-files"
+    let prefix = config.githubPath ? `${config.githubPath}/${relPath}` : relPath;
+    if (prefix.startsWith("/"))
+        prefix = prefix.slice(1);
+    if (prefix.startsWith("./"))
+        prefix = prefix.slice(2);
+    const filesToFetch = tree.filter((item) => item.type === "blob" && item.path.startsWith(prefix + "/"));
+    if (filesToFetch.length === 0) {
+        console.error(`[codex-skills-mcp] Warning: No files found in remote tree for prefix ${prefix}`);
+        // Create an empty dir to prevent repeated failures
+        mkdirSync(skillLocalPath, { recursive: true });
+        return;
+    }
+    console.error(`[codex-skills-mcp] Fetching ${filesToFetch.length} files for skill: ${entry.name}...`);
+    for (const file of filesToFetch) {
+        const rawUrl = `https://raw.githubusercontent.com/${config.githubRepo}/${config.githubBranch}/${file.path}`;
+        // Determine local path by stripping githubPath prefix
+        let relativeFilePath = file.path;
+        if (config.githubPath && relativeFilePath.startsWith(config.githubPath + "/")) {
+            relativeFilePath = relativeFilePath.substring(config.githubPath.length + 1);
+        }
+        const localFilePath = resolve(config.skillsDir, relativeFilePath);
+        mkdirSync(dirname(localFilePath), { recursive: true });
+        const res = await fetchWithAuth(rawUrl, config.githubToken);
+        const buffer = await res.arrayBuffer();
+        writeFileSync(localFilePath, Buffer.from(buffer));
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/remote/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/remote/github.ts"],"names":[],"mappings":"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"}

package/dist/search/index.d.ts

@@ -0,0 +1,45 @@
+import type { ManifestEntry } from "../config.js";
+interface SearchResult {
+    name: string;
+    description: string;
+    category: string;
+    has_sub_skills: boolean;
+    score: number;
+}
+/**
+ * Lightweight keyword search engine with TF-IDF-like scoring.
+ * No external dependencies — pure string matching with Leading Words boosting.
+ */
+export declare class SkillSearchEngine {
+    private index;
+    private categories;
+    constructor(manifest: ManifestEntry[]);
+    private buildIndex;
+    /**
+     * Extract Leading Words from description.
+     * Format: "...。Leading Words: word1, word2, word3"
+     */
+    private extractLeadingWords;
+    private tokenize;
+    /**
+     * Search skills by query string.
+     * Scoring: exact name match > Leading Words match > description token match
+     */
+    search(query: string, options?: {
+        category?: string;
+        limit?: number;
+    }): SearchResult[];
+    /**
+     * Get all categories with skill counts.
+     */
+    getCategories(): {
+        name: string;
+        skill_count: number;
+    }[];
+    /**
+     * Find a skill entry by exact name.
+     */
+    findByName(name: string): ManifestEntry | undefined;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAkC;gBAExC,QAAQ,EAAE,aAAa,EAAE;IAIrC,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,QAAQ;IA2BhB;;;OAGG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAClD,YAAY,EAAE;IAiEjB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE;IAMxD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAMpD"}

package/dist/search/index.js

@@ -0,0 +1,149 @@
+/**
+ * Lightweight keyword search engine with TF-IDF-like scoring.
+ * No external dependencies — pure string matching with Leading Words boosting.
+ */
+export class SkillSearchEngine {
+    index = [];
+    categories = new Map();
+    constructor(manifest) {
+        this.buildIndex(manifest);
+    }
+    buildIndex(manifest) {
+        const categoryCounts = new Map();
+        for (const entry of manifest) {
+            // Skip the router entry itself
+            if (entry.name === "00_codex_skills")
+                continue;
+            // Extract Leading Words from description
+            const leadingWords = this.extractLeadingWords(entry.description);
+            // Tokenize all searchable fields
+            const allText = [
+                entry.name,
+                entry.description,
+                entry.category,
+                entry.folder,
+            ].join(" ");
+            const tokens = this.tokenize(allText);
+            // Detect if this is a sub-skill (path depth > 2 segments)
+            const pathSegments = entry.relative_path.split("/").filter(Boolean);
+            const isSubSkill = pathSegments.length > 3;
+            this.index.push({ entry, tokens, leadingWords, isSubSkill });
+            // Count categories
+            const count = categoryCounts.get(entry.category) || 0;
+            categoryCounts.set(entry.category, count + 1);
+        }
+        this.categories = categoryCounts;
+    }
+    /**
+     * Extract Leading Words from description.
+     * Format: "...。Leading Words: word1, word2, word3"
+     */
+    extractLeadingWords(description) {
+        const match = description.match(/Leading\s*Words?\s*[:：]\s*(.+)$/i);
+        if (!match)
+            return [];
+        return match[1]
+            .split(/[,，、]/)
+            .map((w) => w.trim().toLowerCase())
+            .filter(Boolean);
+    }
+    tokenize(text) {
+        const raw = text
+            .toLowerCase()
+            .replace(/[^\w\u4e00-\u9fff\s-]/g, " ")
+            .split(/\s+/)
+            .filter((t) => t.length > 1);
+        // Generate CJK bigrams for better Chinese matching
+        const result = [...raw];
+        for (const token of raw) {
+            const cjkChars = token.match(/[\u4e00-\u9fff]/g);
+            if (cjkChars && cjkChars.length >= 2) {
+                // Generate bigrams: "前端性能" → ["前端", "端性", "性能"]
+                const cjkStr = cjkChars.join("");
+                for (let i = 0; i < cjkStr.length - 1; i++) {
+                    result.push(cjkStr.substring(i, i + 2));
+                }
+                // Also add individual chars for broader matching
+                for (const c of cjkChars) {
+                    result.push(c);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Search skills by query string.
+     * Scoring: exact name match > Leading Words match > description token match
+     */
+    search(query, options = {}) {
+        const { category, limit = 10 } = options;
+        const queryTokens = this.tokenize(query);
+        if (queryTokens.length === 0)
+            return [];
+        const results = [];
+        for (const item of this.index) {
+            // Category filter
+            if (category && item.entry.category !== category)
+                continue;
+            let score = 0;
+            // 1. Exact name match (highest priority)
+            const nameLower = item.entry.name.toLowerCase();
+            for (const qt of queryTokens) {
+                if (nameLower === qt || nameLower.includes(qt)) {
+                    score += 10;
+                }
+            }
+            // 2. Leading Words match (high priority)
+            for (const qt of queryTokens) {
+                for (const lw of item.leadingWords) {
+                    if (lw.includes(qt) || qt.includes(lw)) {
+                        score += 5;
+                    }
+                }
+            }
+            // 3. General token match
+            for (const qt of queryTokens) {
+                let tokenHits = 0;
+                for (const token of item.tokens) {
+                    if (token.includes(qt) || qt.includes(token)) {
+                        tokenHits++;
+                    }
+                }
+                // Normalize by token count to avoid long descriptions always winning
+                score += tokenHits > 0 ? 1 + Math.log(tokenHits) : 0;
+            }
+            // 4. Sub-skills get a slight penalty to prefer top-level skills
+            if (item.isSubSkill) {
+                score *= 0.7;
+            }
+            if (score > 0) {
+                results.push({
+                    name: item.entry.name,
+                    description: item.entry.description,
+                    category: item.entry.category,
+                    has_sub_skills: false, // Will be enriched by loader
+                    score: Math.round(score * 100) / 100,
+                });
+            }
+        }
+        // Sort by score descending
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    /**
+     * Get all categories with skill counts.
+     */
+    getCategories() {
+        return Array.from(this.categories.entries())
+            .map(([name, skill_count]) => ({ name, skill_count }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Find a skill entry by exact name.
+     */
+    findByName(name) {
+        const nameLower = name.toLowerCase();
+        return this.index.find((item) => item.entry.name.toLowerCase() === nameLower)?.entry;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-categories.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+export declare function registerListCategories(server: McpServer, searchEngine: SkillSearchEngine): void;
+//# sourceMappingURL=list-categories.d.ts.map

package/dist/tools/list-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.d.ts","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,GAC9B,IAAI,CAwBN"}

package/dist/tools/list-categories.js

@@ -0,0 +1,18 @@
+export function registerListCategories(server, searchEngine) {
+    server.tool("list_categories", "List all skill categories in the codex-skills library with their skill counts. Use this to get an overview of available domains.", {}, async () => {
+        const categories = searchEngine.getCategories();
+        const formatted = categories
+            .map((c) => `- **${c.name}**: ${c.skill_count} skills`)
+            .join("\n");
+        const total = categories.reduce((sum, c) => sum + c.skill_count, 0);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Codex-Skills Library: ${total} skills across ${categories.length} categories\n\n${formatted}\n\nUse search_skills(query) to find skills, or search_skills(query, category) to filter by category.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=list-categories.js.map

package/dist/tools/list-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.js","sourceRoot":"","sources":["../../src/tools/list-categories.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,YAA+B;IAE/B,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,kIAAkI,EAClI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,CAAC;QAEhD,MAAM,SAAS,GAAG,UAAU;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,SAAS,CAAC;aACtD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAEpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,yBAAyB,KAAK,kBAAkB,UAAU,CAAC,MAAM,kBAAkB,SAAS,uGAAuG;iBAC1M;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-skill-files.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SkillSearchEngine } from "../search/index.js";
+import type { SkillLoader } from "../loader/index.js";
+export declare function registerListSkillFiles(server: McpServer, searchEngine: SkillSearchEngine, loader: SkillLoader): void;
+//# sourceMappingURL=list-skill-files.d.ts.map

package/dist/tools/list-skill-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-skill-files.d.ts","sourceRoot":"","sources":["../../src/tools/list-skill-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,iBAAiB,EAC/B,MAAM,EAAE,WAAW,GAClB,IAAI,CA8CN"}