用途：将 MCP 服务器配置转换为 Agent Skill，当用户提到“MCP to skill”“把 MCP 服务转成 skill”“生成 MCP skill”等时触发。
主要能力：支持 Stdio MCP（基于 npx）、HTTP MCP，以及不带 mcpServers 包装的直接格式；可从配置的 name 字段提取技能名，输出到 ./skills/<skill-name>/，生成 SKILL.md（约 100 tokens 的指令）与 mcp-config.json。
使用方式：先获取 MCP 配置（对话中直接粘贴，或提供配置文件路径；未提供时需向用户索取）。生成命令：npx -y mcp-to-skill generate --mcp-config /tmp/mcp-config.json --output-dir ./skills/<skill-name>，或 --mcp-config <配置文件路径>。随后必须补充脚本支持：mkdir -p ./skills/<skill-name>/scripts，cp $(dirname $0)/scripts/exec-with-env.sh ./skills/<skill-name>/scripts/，chmod +x ./skills/<skill-name>/scripts/exec-with-env.sh。还需修正生成的 SKILL.md：删除 npx -y mcp-to-skill exec 相关指令，改为 $SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json <tool_name> '{"param": "value"}'，并补充 Commands/Usage 与 Execution Strategy 段落，说明直接执行、失败后再提示配置。测试可创建软链接 ln -s ../../skills/<skill-name> .agents/skills/<skill-name>，或复制到 ~/.config/skills/。
exec-with-env.sh 用于解析 MCP 配置中的 ${VAR} 等环境变量语法，支持 $VAR、${VAR}、${VAR:-default}，在执行前生成临时配置；变量缺失且无默认值时会退出，并校验生成的 JSON。
适用场景：需要把已有 MCP 服务快速封装为可复用 Agent Skill 的工作流。
限制：生成的 SKILL.md 指令需人工修正，脚本支持为必需步骤；环境变量需在执行时解析，缺失会报错。原始项目见 https://github.com/larkinwc/ts-mcp-to-skill。