hnaymyh123-henry/skills-compat-manager

技能竞争管理器

阻止你的AI代理在技能进行中途失败。 一个涵盖你所有代理技能的图书馆——并内置了飞行前检查功能。

快速入门 · 工作原理 · CLI · MCP服务器 · 中文文档

---

为什么你会想要这个

你已经构建（或下载）了大量AI代理技能。它们在你的机器上工作——直到不再有效。

“在Claude代码中能用，但光标无法运行。” “代理开始了任务，然后在ModuleNotFoundError: pandas死亡。” “我将OPENAI_API_KEY设在本地，但代理仍然返回空字符串。”

技能竞争管理器用两个步骤解决了这个问题：

🗂️ 一个库，每个代理。 把你的技能放到一个文件夹里。Claude Code、Cursor、Codex CLI、OpenCode——它们都通过 MCP 从同一个地方读取。不再需要在工具配置间复制粘贴技能。

🛡️ 执行前检查。 每次代理加载技能时，我们都会扫描你的环境，对照该技能声明的依赖关系（包 ·CLI 工具 ·环境变量 ·平台能力），并在顶部注入硬兼容性协议。缺少 pandas？代理在烧毁 10k 代币之前停下来询问。

Skills Compat Manager

Stop your AI agent from failing halfway through a skill. One library for all your agent skills — with a pre-flight check built in.

Quick Start · How It Works · CLI · MCP Server · 中文文档

---

Why You’ll Want This

You’ve built (or downloaded) a bunch of AI agent skills. They work on your machine — until they don’t.

“It worked in Claude Code but Cursor can’t run it.” “The agent started the task, then died on ModuleNotFoundError: pandas.” “I set OPENAI_API_KEY locally but the agent still returned an empty string.”

Skills Compat Manager fixes this in two moves:

🗂️ One library, every agent. Drop your skills into a single folder. Claude Code, Cursor, Codex CLI, OpenCode — they all read from the same place via MCP. No more copy-pasting skills across tool configs.

🛡️ Pre-flight check before execution. Every time an agent loads a skill, we scan your environment against the skill’s declared dependencies (packages · CLI tools · env vars · platform capabilities) and inject a hard compatibility protocol at the top. Missing pandas? The agent stops and asks before burning 10k tokens.

Think of it as package.json + a lockfile checker — but for AI agent skills.

---

See It In Action

Agent: loading skill "pdf-tools" via MCP...

⚠ COMPATIBILITY DELTA — pdf-tools @ claude_code
Status: BLOCKED

Code Dependencies:
  - pandas: missing → pip install pandas
  - pypdf: available (4.0.1)

External Services:
  - OPENAI_API_KEY: missing

─── AGENT PROTOCOL ───
If Status is BLOCKED:
  1. DO NOT execute the skill body below.
  2. Report the missing dependencies to the user, verbatim.
  3. Ask the user how to proceed.

Agent (to you): Before I run pdf-tools, I need two things installed:
  1. pandas (pip install pandas)
  2. OPENAI_API_KEY environment variable
How would you like to proceed?

The agent knows what’s missing before it writes a single line of code.

---

What This Tool Does — and Doesn’t

Does