为 AGENT 扩充能力

想给 Agent 增加的能力，一键接入。

为 Claude、Cursor 和 Codex 接入统一的运行时。按需搜索能力、审核版本计划，自动写入宿主配置。

Node.js ≥ 22.13.0npm + MCP当前：源码安装

开始之前

当前提供源码与本地构建包。以下命令从已下载的 SkillFlux 仓库根目录执行；暂不以公开 npm 发布为安装前提。

安装本地 CLI

构建当前版本并安装 skillflux 命令。确认 Node.js 版本满足要求后，再执行下面四条命令。

TERMINAL · 仓库根目录

npm ci
npm run build --workspace @skillflux/mcp
npm pack --workspace @skillflux/mcp
npm install -g ./skillflux-mcp-1.0.0.tgz

SkillFlux 的精选技能保存在 GitHub 目录仓库中。init 会解析仓库当前 commit 并固定它，之后所有下载都来自这个 commit 地址，并逐一校验文件哈希。

vc999999999/skillflux-catalog

只有完成真实评测并获批准的版本才可安装。当前可用版本以精品库和客户端搜索结果为准。

进入目标项目，选择宿主后复制命令。init 合并项目内的 MCP 配置，保留已有服务器，并固定目录仓库身份。

TERMINAL · 你的项目

cd /path/to/your-project
skillflux init --project . --repo vc999999999/skillflux-catalog --host codex

MCP 配置.codex/config.toml

入口 Skill.agents/skills/skillflux/

替换 /path/to/your-project 为真实项目路径。宿主重新读取 MCP 配置后，再显式调用 SkillFlux；Codex 中使用 $skillflux。通用宿主可能需要手动加载入口。

允许 MCP 直接安装已审核的纯文本包

只有明确在 init 命令中加入 --preauthorize-reviewed-text，MCP 才能直接安装已批准、完成用途与边界测试且无网络、Shell 或密钥权限的纯文本包。默认通过 CLI 安装；具体版本升级仍需明确确认。

搜索在本地缓存的目录索引上进行，检索词不会离开你的机器。从返回结果中选择 Skill 和精确版本，查看 plan 输出的权限、依赖和文件，确认后使用它返回的计划 ID 安装。

TERMINAL · 你的项目

skillflux search "code review"
skillflux plan SKILL_ID --version VERSION
skillflux install PLAN_ID
skillflux load SKILL_ID

将 SKILL_ID、VERSION 和 PLAN_ID 替换为实际返回值。安装时逐文件下载并校验哈希、资格与撤销状态；load 在当前轮提供技能入口和所需资源。

check-updates 只检查；update 指定精确版本后展示计划并等待终端确认。pin 可固定版本，升级前需先 unpin。

TERMINAL

skillflux check-updates
skillflux update SKILL_ID@VERSION
skillflux pin SKILL_ID

目录索引缓存最长 24 小时，手动检查默认刷新。离线状态会标明缓存时间与未知项；安装、升级和回滚需要在线检查资格与撤销。

目录里的来源，都能一键安装吗？

来源目录帮助你发现第三方资源。SkillFlux 的安装命令只用于当前目录仓库已批准的版本；第三方 MCP 服务器或合集请查看原站的接入说明。

是否修改全局 AI 工具配置？

init 只写入指定项目的 MCP 配置与入口文件，保留已有服务器，遇到用户自有入口文件时不会直接覆盖。

接入后会自动运行所有 Skill 吗？

需要用户显式调用。宿主读取轻量入口后，由本地 MCP Runtime 搜索、校验和加载；网站不替你运行模型。

接入完成，开始找一个合适的 Skill。

浏览当前可用版本，或先从资源目录开始。