Cherry Studio Skills Manager 实战指南Claude Code Agent Skills 的搜索、安装与创建管理【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio本文以 Cherry Studio 内置 Cherry Assistant 中的skills-manager技能SKILL.md为骨架完整拆解其搜索—安装—创建—验证四步闭环优先复用内置工具搜索安装第三方 Skill缺失时降级到 CLI需要新能力时移交 skill-creator 创建自定义 Skill。读完本文你将掌握在 Cherry Studio 中安全引入外部 Agent Skills、规范创建自有 Skill 的完整方法并理解底层 SkillService 的存储、镜像与白名单机制。一、Skills Manager 在 Cherry Studio 中的定位Cherry Studio 内置的 Cherry Assistant 通过一组.claude/skills/技能目录来组织 Agent 能力。其中skills-manager是一个元技能——它的职责不是完成某个具体业务任务而是协调其他技能与工具完成 Skill 的搜索、安装和创建。其 frontmatter 中的触发条件非常宽泛用户说find a skill搜索技能帮我做个 skillcreate a skill用户说有没有做 X 的工具我想扩展 Agent 能力当前能力不足需要先查找可复用方案的场景可以看到Skills Manager 是 Agent 面对能力缺口时的统一入口它决定了 Agent 是去市场上找现成技能、直接用 CLI 安装还是调用 skill-creator 现场创作。从仓库源码结构看与它协作的还有两个同层技能cherry-skill-marketplace面向 MCP 工具mcp__skills__search_skills/mcp__skills__install_skill的市场路由负责搜索、安装以及引导用户在 Skills UI 中管理已安装技能find-skills声明了search_skills(query)与install_skill(install_source)两个内置工具的实现语义。二者可推断为 Skills Manager 文档中优先复用 find-skills所指的实际落地对象而skill-creatorSKILL.md则是创建自定义 Skill流程的专属执行者。二、搜索与安装两级执行路径Skills Manager 对搜索和安装定义了清晰的两级优先级先复用内置搜索工具再降级到 CLI。1. 优先复用 find-skills主路径文档明确要求find-skills可用时先调用它完成搜索、质量检查和安装确认只有不可用时才执行下面的 CLI 降级流程。对应到 find-skills 的实现其执行链路如下搜索调用内置工具search_skills(query)按关键词检索技能市场返回匹配结果及不透明的install_source值安装调用内置工具install_skill(install_source)Cherry 会克隆仓库、仅安装这一个技能到托管库并在单一确定性步骤中完成注册。文档特别强调不要用npx skills add、git clone等 shell 命令替代因为那会安装整个仓库数十个技能、向其他工具散布符号链接且落在 Cherry 管理库之外权限安装动作受当前 Claude 权限模式约束default / accept-edits 模式可能经 SDK 弹窗确认bypass-permissions 模式直接执行。2. CLI 降级流程备选路径当内置工具不可用时Skills Manager 按顺序尝试以下运行时优先npx skills备选$CHERRY_STUDIO_BUN_PATH x skills两者都没有则提示用户安装 Node.js搜索的标准动作是理解需求 → 提取关键词 → 执行npx skills find [query]→ 向用户展示技能的名称、功能与来源。安装的标准动作遵循严格的四步安全流程展示安全警告 → 提供源码链接 → 用户确认 → npx skills add owner/reposkill -y其中的-y参数用于跳过交互确认。安装位置有两类项目级.claude/skills/跟随项目、随仓库分发用户级~/.claude/skills/全局可用、跨项目生效3. 搜索无结果时的处理文档给出了明确的兜底顺序告知用户没有找到现成 Skill先尝试用 Agent 自身通用能力直接完成任务如果这是可复用的流程再建议创建自定义 Skill。这与 find-skills 的没有结果段落完全一致承认未找到 → 直接提供帮助 → 提议为重复性任务创作自定义技能由 skill-creator 处理。三、安装安全第三方代码的边界管理Skills Manager 将安全提示放在安装动作的最前端这是整个流程中不可省略的环节Skills 是第三方代码拥有完整权限。一个恶意的 Skill 可以读取、修改甚至删除用户系统上的文件——这一点在 find-skills 中同样被显著标注安装前必须展示安全警告说明该技能是第三方代码将以完整 Agent 权限运行必须提供源码链接让用户能审阅该技能的SKILL.md及其包含的脚本必须取得用户明确确认后才执行安装命令。换言之Skills Manager 刻意把信任决策保留给人类用户Agent 只负责把风险和审查入口透明化。从源码层面看这份警惕同样体现在 SkillService 的工程实现中安装过程封装在 SkillService.ts 的SkillInstaller中并配有mutationLockMutex将所有库变更安装/卸载/内置同步/对账串行化防止并发读取到中间态技能安装后并不直接暴露给运行时而是按会话下发名称白名单buildSkillWhitelist镜像目录在会话构建期不会被随意改动。四、创建 Skills先复用、再创作、必须验证Skills Manager 对创建的要求比搜索安装更严格因为它直接决定新增能力是否会被正确触发与执行。步骤 1确认值得创建文档要求先回答两个问题现有 Skill 是否确实无法满足需求这是不是值得复用的流程如果只是一次性任务直接完成即可不强行创建 Skill——避免为单次使用引入永久维护负担。步骤 2优先调用 skill-creator检查可用技能列表skill-creator可用时必须调用它并完整遵循其需求澄清、初始化、编辑、验证和迭代流程不要绕过它直接手写SKILL.md。skill-creatorSKILL.md提供了远超写一个文件的完整工程化流程需求澄清捕获用户意图——技能应让 Agent 能做什么、何时触发、期望的输出格式、是否需要测试用例初始化在$CHERRY_STUDIO_SKILLS_DIRCherry 的托管技能库下创建目录与SKILL.md文件夹名与 frontmattername必须一致且仅使用小写字母、数字与连字符如my-cool-skill编辑遵循渐进式披露结构——元数据name description常驻上下文、SKILL.md正文在触发时加载理想 500 行、scripts/references/assets/按需加载验证与迭代编写 2-3 个真实测试提示词同时启动带技能与基线两个子代理跑分用scripts.aggregate_benchmark聚合、eval-viewer/generate_review.py生成审查页依据用户反馈迭代改进描述优化生成 20 条应触发/不应触发的评测查询用scripts.run_loop自动迭代 description防止技能欠触发。步骤 3CLI 降级初始化仅当skill-creator确实不可用时才明确告诉用户正在降级然后执行npx skills init skill-name初始化后保持SKILL.md精简并按需加入三类支持资源目录用途加载时机scripts/可执行代码用于确定性/重复性任务执行时按需加载references/文档作为上下文按需引入需要时加载assets/输出用文件模板、图标、字体生成产物时使用关于 SKILL.md 的最小结构与 frontmatter 字段可参考 claude-automation-recommender 的 skills-reference其中给出了disable-model-invocation、user-invocable、allowed-tools、context、agent等字段的取值与用户/Claude 谁能触发的对应关系以及$ARGUMENTS参数模式和!command 动态上下文注入等进阶写法。步骤 4创建后必须验证创建完成后至少验证三件事验证失败就修正后重跑frontmatter是否合法name与description字段是否齐全、命名是否符合规范触发描述是否准确覆盖目标场景description 是 Skill 最主要的触发机制一个真实用例是否跑通。从代码层面看仓库确实为 Skill 元数据解析提供了支撑markdownParser 中的parseSkillMetadata、findSkillMdPath、findAllSkillDirectories被 SkillService.ts 用于读取每个技能目录的元数据——这就是验证 frontmatter的底层实现。五、与 Cherry Skill Marketplace 的分工Skills Manager 与同层技能 cherry-skill-marketplace 在职责上互补而不重叠能力环节skills-managercherry-skill-marketplace触发时机搜索/安装/创建 Skill 的通用意图明确要求搜索、安装、查看、卸载、创建 Skill或内置能力出现缺口搜索优先find-skills降级npx skills findmcp__skills__search_skills安装确认后npx skills addCLI 降级路径确认后mcp__skills__install_skill查看/卸载—通过mcp__assistant__product_info读取 manifest 路由导航到 Skills UI 完成创建移交skill-creator移交内置skill-creator不重复实现失败处理告知无结果 → 直接完成 → 建议创建能力缺口必须立即补足不得只回复 unsupported二者共享同一条安全底线第三方 Skill 安装前必须取得用户明确同意、说明其将继承当前工具权限且不向第三方发送凭据、附件内容或本地路径。marketplace 技能还额外强调工具错误原样概括不把失败说成成功也不偷偷切换到 npx 或全局安装。六、底层机制Skill 如何被存储与生效Skills Manager 的指令最终都落到 Cherry Studio 的 Skill 管理服务上。从 SkillService.ts 的类注释可以看到完整的存储模型规范库技能存储在{dataPath}/Skills/{folderName}/这是应用拥有的权威技能库镜像机制安装/卸载/启动对账linkMirror/reconcileSkills时技能会被镜像到CLAUDE_CONFIG_DIR/skills供 Claude Agent SDK 发现白名单隔离每个会话只把名称白名单buildSkillWhitelist下发给 SDK镜像目录在会话构建期不会被改动——这既保证能力可见又避免会话期间的意外篡改两级元数据技能库级元数据存于agent_global_skill表每个 Agent 的启用状态存于agent_skill关联表schema 见 agentSkill.ts变更串行化所有库变更通过mutationLockMutex串行执行并对启动时的并发对账做去重reconcileInFlight。这意味着无论通过内置工具、CLI 还是手工写入$CHERRY_STUDIO_SKILLS_DIR创建技能最终都会进入同一个托管库并统一经历镜像与注册——这也是创建后无需额外注册步骤skill-creator 中明确说明的根本原因。七、最佳实践小结基于以上完整流程在实际使用中建议遵循以下原则搜索优先创建兜底先search_skills/npx skills find找现成技能无结果且任务可复用时才创建自定义 Skill安装必过安全三关展示第三方代码风险 → 提供源码链接 → 获得用户确认缺一不可创建必走 skill-creator不绕过它手写 SKILL.md创建后至少验证 frontmatter、触发描述与一个真实用例注意运行时差异内置工具可用时绝不降级到npx/git安装避免整个仓库被引入并散落到 Cherry 管理库之外区分任务与能力一次性任务直接完成不要强行造 Skill只有值得复用的流程才值得固化为技能。通过这套搜索—安装—创建—验证闭环Cherry Studio 的 Cherry Assistant 可以在保持安全边界的前提下持续从开放技能生态中补充能力或为用户的重复性工作沉淀自有技能——这正是 Skills Manager 作为元技能的核心价值所在。【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Cherry Studio Skills Manager 实战指南：Claude Code Agent Skills 的搜索、安装与创建管理
Cherry Studio Skills Manager 实战指南Claude Code Agent Skills 的搜索、安装与创建管理【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio本文以 Cherry Studio 内置 Cherry Assistant 中的skills-manager技能SKILL.md为骨架完整拆解其搜索—安装—创建—验证四步闭环优先复用内置工具搜索安装第三方 Skill缺失时降级到 CLI需要新能力时移交 skill-creator 创建自定义 Skill。读完本文你将掌握在 Cherry Studio 中安全引入外部 Agent Skills、规范创建自有 Skill 的完整方法并理解底层 SkillService 的存储、镜像与白名单机制。一、Skills Manager 在 Cherry Studio 中的定位Cherry Studio 内置的 Cherry Assistant 通过一组.claude/skills/技能目录来组织 Agent 能力。其中skills-manager是一个元技能——它的职责不是完成某个具体业务任务而是协调其他技能与工具完成 Skill 的搜索、安装和创建。其 frontmatter 中的触发条件非常宽泛用户说find a skill搜索技能帮我做个 skillcreate a skill用户说有没有做 X 的工具我想扩展 Agent 能力当前能力不足需要先查找可复用方案的场景可以看到Skills Manager 是 Agent 面对能力缺口时的统一入口它决定了 Agent 是去市场上找现成技能、直接用 CLI 安装还是调用 skill-creator 现场创作。从仓库源码结构看与它协作的还有两个同层技能cherry-skill-marketplace面向 MCP 工具mcp__skills__search_skills/mcp__skills__install_skill的市场路由负责搜索、安装以及引导用户在 Skills UI 中管理已安装技能find-skills声明了search_skills(query)与install_skill(install_source)两个内置工具的实现语义。二者可推断为 Skills Manager 文档中优先复用 find-skills所指的实际落地对象而skill-creatorSKILL.md则是创建自定义 Skill流程的专属执行者。二、搜索与安装两级执行路径Skills Manager 对搜索和安装定义了清晰的两级优先级先复用内置搜索工具再降级到 CLI。1. 优先复用 find-skills主路径文档明确要求find-skills可用时先调用它完成搜索、质量检查和安装确认只有不可用时才执行下面的 CLI 降级流程。对应到 find-skills 的实现其执行链路如下搜索调用内置工具search_skills(query)按关键词检索技能市场返回匹配结果及不透明的install_source值安装调用内置工具install_skill(install_source)Cherry 会克隆仓库、仅安装这一个技能到托管库并在单一确定性步骤中完成注册。文档特别强调不要用npx skills add、git clone等 shell 命令替代因为那会安装整个仓库数十个技能、向其他工具散布符号链接且落在 Cherry 管理库之外权限安装动作受当前 Claude 权限模式约束default / accept-edits 模式可能经 SDK 弹窗确认bypass-permissions 模式直接执行。2. CLI 降级流程备选路径当内置工具不可用时Skills Manager 按顺序尝试以下运行时优先npx skills备选$CHERRY_STUDIO_BUN_PATH x skills两者都没有则提示用户安装 Node.js搜索的标准动作是理解需求 → 提取关键词 → 执行npx skills find [query]→ 向用户展示技能的名称、功能与来源。安装的标准动作遵循严格的四步安全流程展示安全警告 → 提供源码链接 → 用户确认 → npx skills add owner/reposkill -y其中的-y参数用于跳过交互确认。安装位置有两类项目级.claude/skills/跟随项目、随仓库分发用户级~/.claude/skills/全局可用、跨项目生效3. 搜索无结果时的处理文档给出了明确的兜底顺序告知用户没有找到现成 Skill先尝试用 Agent 自身通用能力直接完成任务如果这是可复用的流程再建议创建自定义 Skill。这与 find-skills 的没有结果段落完全一致承认未找到 → 直接提供帮助 → 提议为重复性任务创作自定义技能由 skill-creator 处理。三、安装安全第三方代码的边界管理Skills Manager 将安全提示放在安装动作的最前端这是整个流程中不可省略的环节Skills 是第三方代码拥有完整权限。一个恶意的 Skill 可以读取、修改甚至删除用户系统上的文件——这一点在 find-skills 中同样被显著标注安装前必须展示安全警告说明该技能是第三方代码将以完整 Agent 权限运行必须提供源码链接让用户能审阅该技能的SKILL.md及其包含的脚本必须取得用户明确确认后才执行安装命令。换言之Skills Manager 刻意把信任决策保留给人类用户Agent 只负责把风险和审查入口透明化。从源码层面看这份警惕同样体现在 SkillService 的工程实现中安装过程封装在 SkillService.ts 的SkillInstaller中并配有mutationLockMutex将所有库变更安装/卸载/内置同步/对账串行化防止并发读取到中间态技能安装后并不直接暴露给运行时而是按会话下发名称白名单buildSkillWhitelist镜像目录在会话构建期不会被随意改动。四、创建 Skills先复用、再创作、必须验证Skills Manager 对创建的要求比搜索安装更严格因为它直接决定新增能力是否会被正确触发与执行。步骤 1确认值得创建文档要求先回答两个问题现有 Skill 是否确实无法满足需求这是不是值得复用的流程如果只是一次性任务直接完成即可不强行创建 Skill——避免为单次使用引入永久维护负担。步骤 2优先调用 skill-creator检查可用技能列表skill-creator可用时必须调用它并完整遵循其需求澄清、初始化、编辑、验证和迭代流程不要绕过它直接手写SKILL.md。skill-creatorSKILL.md提供了远超写一个文件的完整工程化流程需求澄清捕获用户意图——技能应让 Agent 能做什么、何时触发、期望的输出格式、是否需要测试用例初始化在$CHERRY_STUDIO_SKILLS_DIRCherry 的托管技能库下创建目录与SKILL.md文件夹名与 frontmattername必须一致且仅使用小写字母、数字与连字符如my-cool-skill编辑遵循渐进式披露结构——元数据name description常驻上下文、SKILL.md正文在触发时加载理想 500 行、scripts/references/assets/按需加载验证与迭代编写 2-3 个真实测试提示词同时启动带技能与基线两个子代理跑分用scripts.aggregate_benchmark聚合、eval-viewer/generate_review.py生成审查页依据用户反馈迭代改进描述优化生成 20 条应触发/不应触发的评测查询用scripts.run_loop自动迭代 description防止技能欠触发。步骤 3CLI 降级初始化仅当skill-creator确实不可用时才明确告诉用户正在降级然后执行npx skills init skill-name初始化后保持SKILL.md精简并按需加入三类支持资源目录用途加载时机scripts/可执行代码用于确定性/重复性任务执行时按需加载references/文档作为上下文按需引入需要时加载assets/输出用文件模板、图标、字体生成产物时使用关于 SKILL.md 的最小结构与 frontmatter 字段可参考 claude-automation-recommender 的 skills-reference其中给出了disable-model-invocation、user-invocable、allowed-tools、context、agent等字段的取值与用户/Claude 谁能触发的对应关系以及$ARGUMENTS参数模式和!command 动态上下文注入等进阶写法。步骤 4创建后必须验证创建完成后至少验证三件事验证失败就修正后重跑frontmatter是否合法name与description字段是否齐全、命名是否符合规范触发描述是否准确覆盖目标场景description 是 Skill 最主要的触发机制一个真实用例是否跑通。从代码层面看仓库确实为 Skill 元数据解析提供了支撑markdownParser 中的parseSkillMetadata、findSkillMdPath、findAllSkillDirectories被 SkillService.ts 用于读取每个技能目录的元数据——这就是验证 frontmatter的底层实现。五、与 Cherry Skill Marketplace 的分工Skills Manager 与同层技能 cherry-skill-marketplace 在职责上互补而不重叠能力环节skills-managercherry-skill-marketplace触发时机搜索/安装/创建 Skill 的通用意图明确要求搜索、安装、查看、卸载、创建 Skill或内置能力出现缺口搜索优先find-skills降级npx skills findmcp__skills__search_skills安装确认后npx skills addCLI 降级路径确认后mcp__skills__install_skill查看/卸载—通过mcp__assistant__product_info读取 manifest 路由导航到 Skills UI 完成创建移交skill-creator移交内置skill-creator不重复实现失败处理告知无结果 → 直接完成 → 建议创建能力缺口必须立即补足不得只回复 unsupported二者共享同一条安全底线第三方 Skill 安装前必须取得用户明确同意、说明其将继承当前工具权限且不向第三方发送凭据、附件内容或本地路径。marketplace 技能还额外强调工具错误原样概括不把失败说成成功也不偷偷切换到 npx 或全局安装。六、底层机制Skill 如何被存储与生效Skills Manager 的指令最终都落到 Cherry Studio 的 Skill 管理服务上。从 SkillService.ts 的类注释可以看到完整的存储模型规范库技能存储在{dataPath}/Skills/{folderName}/这是应用拥有的权威技能库镜像机制安装/卸载/启动对账linkMirror/reconcileSkills时技能会被镜像到CLAUDE_CONFIG_DIR/skills供 Claude Agent SDK 发现白名单隔离每个会话只把名称白名单buildSkillWhitelist下发给 SDK镜像目录在会话构建期不会被改动——这既保证能力可见又避免会话期间的意外篡改两级元数据技能库级元数据存于agent_global_skill表每个 Agent 的启用状态存于agent_skill关联表schema 见 agentSkill.ts变更串行化所有库变更通过mutationLockMutex串行执行并对启动时的并发对账做去重reconcileInFlight。这意味着无论通过内置工具、CLI 还是手工写入$CHERRY_STUDIO_SKILLS_DIR创建技能最终都会进入同一个托管库并统一经历镜像与注册——这也是创建后无需额外注册步骤skill-creator 中明确说明的根本原因。七、最佳实践小结基于以上完整流程在实际使用中建议遵循以下原则搜索优先创建兜底先search_skills/npx skills find找现成技能无结果且任务可复用时才创建自定义 Skill安装必过安全三关展示第三方代码风险 → 提供源码链接 → 获得用户确认缺一不可创建必走 skill-creator不绕过它手写 SKILL.md创建后至少验证 frontmatter、触发描述与一个真实用例注意运行时差异内置工具可用时绝不降级到npx/git安装避免整个仓库被引入并散落到 Cherry 管理库之外区分任务与能力一次性任务直接完成不要强行造 Skill只有值得复用的流程才值得固化为技能。通过这套搜索—安装—创建—验证闭环Cherry Studio 的 Cherry Assistant 可以在保持安全边界的前提下持续从开放技能生态中补充能力或为用户的重复性工作沉淀自有技能——这正是 Skills Manager 作为元技能的核心价值所在。【免费下载链接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs项目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考