auto-skill-loader

Give your AI agent a persistent skill library it auto-loads at session start.

⚠️ OpenCode image workflow note (April 2026): OpenCode has two issues with images via MCP: (1) its stdio transport for local MCP servers is broken (causes "login fail" errors) — our proxy tools work around this, but (2) pasted images render visually but don't expose real file paths to tools (they appear as filenames). For images in OpenCode, you must give an actual file path rather than pasting. Claude Code doesn't have either of these issues.

Core value prop: This tool was built so skills auto-load at session start in OpenCode — no manual use_skill invocation needed. The proxy tools (vision + web search) are a bonus. If you only need vision in Claude Code, use minimax-token-plan directly instead.

mcp-name: io.github.divitkashyap/auto-skill-loader

How it works

1. You configure which skills to auto-load in ~/.config/auto-skill-loader/config.yaml
2. The MCP server reads skill files from your skills directory and exposes them via skills://active
3. At session start your agent reads skills://active and gets all approved skills auto-injected
4. No explicit triggers needed — the agent already knows your skills

Why

The main problem: In OpenCode, skills don't auto-load — the agent has to explicitly invoke them or rely on unreliable fuzzy matching. auto-skill-loader solves this by exposing your skill library as an MCP resource that gets read at session start. Deterministic, no guessing.

Bonus: Our proxy tools also work around OpenCode's broken MCP stdio transport for the MiniMax vision and web search tools.

Installation

Option 1: uvx (recommended — no install needed)

uvx auto-skill-loader

Option 2: pip

pip install auto-skill-loader
auto-skill-loader

Option 3: Build from source

git clone https://github.com/divitkashyap/auto-skill-loader.git
cd auto-skill-loader
pip install -e .
auto-skill-loader

Configuration

OpenCode

Add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "auto-skill-loader": {
      "type": "local",
      "command": ["uvx", "auto-skill-loader"],
      "enabled": true
    }
  }
}

Claude Code

Note: Claude Code requires a specific JSON format via add-json:

claude mcp add-json -s user auto-skill-loader '{"type":"stdio","command":"/FULL/PATH/TO/python","args":["-m","server"],"env":{"MINIMAX_TOKEN_PLAN_KEY":"sk-cp-YOUR-KEY-HERE"}}'

Replace /FULL/PATH/TO/python with the path to your Python (e.g. /Users/YOU/auto-skill-loader/.venv/bin/python).

Or for uvx (requires network on first run):

claude mcp add -s user --transport stdio -e MINIMAX_TOKEN_PLAN_KEY=sk-cp-YOUR-KEY auto-skill-loader -- uvx auto-skill-loader

Tested On

Skill auto-loading confirmed working on both hosts. The vision proxy bypasses OpenCode's broken stdio transport, but image paste-to-path is a separate rendering issue in OpenCode that requires using file paths.

Other MCP-compatible hosts (Cursor, Zed, etc.) should work with the same configuration — contributions welcome.

Platform Differences & Known Issues

Image Input: OpenCode vs Claude Code

Both hosts work with auto-skill-loader vision tools, but image input behaves differently:

OpenCode note: When you paste an image in OpenCode, it may ren

... View full README on GitHub