Created by Farhan Dhrubo - Patreon - Submit an issue

Universal MCP skill dispatcher for AI coding agents. Load Claude Code skills, OpenCode skills, Cursor rules, Gemini-style markdown, command files, and external GitHub skill repos on demand without bloating every prompt.

Dynamic Skill Loader is a zero-dependency Node.js MCP server and CLI for developers building with Claude Code, OpenCode, Cursor, Windsurf, Aider, Gemini CLI, Codex, Antigravity, Kilo Code, Augment, Hermes, Mistral Vibe, and other MCP-compatible coding assistants.

• On-demand AI skills: match the current task to the right skill instead of loading every instruction file.
• Universal agent routing: filter skills by agent so Claude, Cursor, Codex, OpenCode, and Gemini each see compatible formats.
• External repo import: clone and index skills from any public GitHub repository with --import-repo.
• Context lifecycle management: track active skills, score relevance, and unload stale instructions when the task changes.
• Multi-format parser: supports YAML frontmatter, plain markdown, Gemini blockquotes, .claude/commands, and Claude Code skill files.
• Security hardened: validates Git URLs, blocks path traversal, rejects prototype pollution keys, limits input size, and keeps MCP stdout clean.

git clone --depth 1 --single-branch https://github.com/farhanic017/dynamic-skill-loader.git
cd dynamic-skill-loader
node index.mjs --skills-dir ./skills --list
node index.mjs --skills-dir ./skills --match "build a GSAP landing page"

Run as an MCP server:

node index.mjs --skills-dir ./skills

Add it to an MCP-compatible assistant:

{
  "mcp": {
    "skill-dispatcher": {
      "type": "local",
      "enabled": true,
      "command": [
        "node",
        "/path/to/dynamic-skill-loader/index.mjs",
        "--skills-dir",
        "/path/to/your/skills"
      ]
    }
  }
}

AI coding agents get weaker when every framework rule, design guide, deployment note, and workflow instruction is stuffed into context at once. Dynamic Skill Loader keeps those instructions searchable and loads only what the current task needs.

Use it for:

• Claude Code skill libraries
• OpenCode and Cursor workflow instructions
• MCP-powered agent toolkits
• Personal AI coding playbooks
• Team skill repositories
• Prompt and context optimization
• Agent-specific rule routing
• Reusing skills across multiple coding assistants

---
name: gsap-core
description: Core GSAP animation library
triggers:
  - gsap
  - animation
  - tween
tags:
  - motion
aliases:
  - gsap-core
---

# gsap-core

Full skill instructions here.

# My Skill Name

> A short description can be inferred from a blockquote.

The body must be long enough to identify this file as a useful skill.

# my-gemini-skill

> This blockquote description identifies the skill.

---
description: Deploy the current branch to staging
---

1. Run tests.
2. Build.
3. Deploy.

---
name: my-claude-skill
description: A Claude Code skill with standard frontmatter
triggers:
  - cc-task
---

# Skill instructions

# List all skills
node index.mjs --skills-dir ./skills --list

# Match by task
node index.mjs --skills-dir ./skills --match "animation gsap"

# Import an external skill repo
node index.mjs --skills-dir ./skills --import-repo https://github.com/user/claude-skills

# Show skills from one origin
node index.mjs --skills-dir ./skills --origin local --list

# Switch agent routing
node index.mjs --skills-dir ./skills --agent cursor --list

# List command files
node index.mjs --skills-dir ./skills --list-commands

# Load full skill content
node index.mjs --skills-dir ./skills --get gsap-core

# Set task context and get lifecycle guidance
node index.mjs --skills-dir ./skills --context "building a hero section"

# Show active skills
node index.mjs --skills-dir ./skills --active

# Unload a stale skill
node index.mjs --skills-dir ./skills --unload gsap-core

dynamic-skill-loader/
|-- index.mjs             # MCP server and CLI
|-- install.py            # Optional installer
|-- ALWAYS_ON.md          # Always-on skill dispatcher instructions
|-- SKILL.md              # Self-describing skill
|-- skills/               # Example skills
|-- aggressive-test.mjs   # Aggressive test suite
|-- test.mjs              # Focused test suite
|-- README.md
|-- LICENSE
|-- NOTICE
`-- package.json

Add these topics in the GitHub repository sidebar to improve discovery:

mcp, mcp-server, model-context-protocol, ai-agent, ai-coding, claude-code, opencode, cursor-ai, codex, gemini-cli, skill-loader, prompt-engineering, context-management, developer-tools, agent-tools

Bug reports, feature requests, docs improvements, and new skill-format examples are welcome. See CONTRIBUTING.md.

If this saves tokens or makes your AI coding workflow cleaner, starring the repo helps other developers find it.

Copyright (c) 2026 Farhan Dhrubo.

Licensed under the GNU General Public License v3.0. See NOTICE for attribution details.