skills.rest
kdpa-llc
kdpa-llcOFFICIAL
Explore all skills by this author →
GitHub

local-skills-mcp-guide

Aggregate local skills from SKILL.md metadata across multiple directories for MCP server exposure.

34|7|Updated Oct 30, 2025
Search Tags:#development#architecture#contribution#TypeScript#MCP server#skill loader#codebase guide
One-click install
npx skills add https://github.com/kdpa-llc/local-skills-mcp --skill local-skills-mcp-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-skills-mcp-guide
Source: https://github.com/kdpa-llc/local-skills-mcp/tree/main/skills/local-skills-mcp-guide
Command: npx skills add https://github.com/kdpa-llc/local-skills-mcp --skill local-skills-mcp-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? This Skill demystifies the internal workings of the Local Skills MCP server, providing developers and contributors with a clear understanding of its architecture, file structure, and implementation details. It removes the guesswork from exploring, debugging, or contributing to the project.

Core Features & Use Cases

  • Codebase Overview: Explains the purpose of key files like src/index.ts (server implementation) and src/skill-loader.ts (skill aggregation logic).
  • Internal Mechanics: Details how skill discovery, lazy loading for context efficiency, and multi-directory aggregation priority are implemented.
  • Use Case: If you're looking to add a new skill aggregation path, modify how skills are loaded, or contribute a new feature, this guide provides the essential internal context to get started quickly.

Quick Start

Use the local-skills-mcp-guide skill to understand how skill aggregation priority is implemented in the Local Skills MCP server.

Frequently Asked Questions about local-skills-mcp-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I discover and aggregate local skills from multiple directories in an MCP server?▼

Local Skills MCP discovers skills from SKILL.md metadata across ~/.claude/skills/, ./.claude/skills/, ./skills, and $SKILLS_DIR, parsing YAML frontmatter and caching results for dynamic tool exposure to Claude-compatible agents.

What's the internal architecture of the Local Skills MCP server and how does skill loading work?▼

The Local Skills MCP uses src/index.ts for server implementation and src/skill-loader.ts for aggregation logic, handling lazy loading, multi-directory precedence resolution, and dynamic generation of skill tool descriptions.

How do I add a new skill aggregation path or modify the skill loading process?▼

Understanding the codebase structure—including YAML frontmatter parsing, name and description validation, in-memory caching, and directory precedence resolution—enables you to extend aggregation paths or customize the skill-loader behavior.

Can I use the Local Skills MCP with TypeScript-based skill implementations?▼

Yes, the Local Skills MCP server is implemented in TypeScript and supports skill aggregation for TypeScript-based skills through its YAML frontmatter parsing and dynamic tool generation for MCP clients.

What happens when skills are defined in multiple directories with the same name?▼

Directory precedence resolution determines which skill takes priority: ~/.claude/skills/, ./.claude/skills/, ./skills, and $SKILLS_DIR are checked in order, with the first match loaded and cached in memory.

How do I understand the skill metadata format required for discovery?▼

Skills must include SKILL.md with YAML frontmatter containing validated name and description fields; the Local Skills MCP aggregates these metadata entries to expose skills dynamically to Claude and other MCP-compatible agents.

Related Skills

Explore More Software Engineering Skills→
iautom8thingsiautom8things
6

elixir-test-critic

Generate structured metadata for SKILL.md-based units in repositories.

Community
Advanced
haojing8312haojing8312
154

mcp-cli

Discover and invoke MCP server tools, resources, and prompts via the mcp CLI.

Community
Intermediate
blencorpblencorp
101

tanstack-router

Implement type-safe file-based routing with TanStack Router in React/TypeScript projects.

Official
Intermediate
closedloop-aiclosedloop-ai
102

find-plugin-file

Locate files in the Claude Code plugins cache by latest version.

Official
Basic