Palmier Pro技能系统进阶：从SKILL.md编写到社区技能市场分发的完整指南

Palmier Pro技能系统进阶从SKILL.md编写到社区技能市场分发的完整指南【免费下载链接】palmier-promacOS video editor built for AI项目地址: https://gitcode.com/GitHub_Trending/pa/palmier-proPalmier Pro 是一款专为 AI 打造的 macOS 视频编辑器而它的技能系统Skills是让整个 AI 助手越用越顺手的核心你只需编写一份SKILL.md文件就能教会应用内 Agent 一整套专属剪辑工作流还可以从社区技能市场一键安装、自动更新甚至把自己的工作流分发出去。本文将带你完整走通这条链路。技能是什么一个文件夹 一份 SKILL.mdPalmier Pro 的技能系统非常克制——没有复杂的工程模板技能就是磁盘上的一个文件夹~/.palmier/skills/ └── my-style-preset/ └── SKILL.md文件夹名即技能 IDSKILL.md是唯一的真相来源。文件格式由 SkillFrontmatter 定义结构如下--- name: 胶片颗粒风格 description: 当用户要求复古胶片质感时应用此调色工作流。 --- ## Workflow 1. 打开 Adjust 面板降低高光。 2. 在 Grain 中叠加粗颗粒……三条硬性规则字段要求上限name必填单行120 字符description必填单行写给 Agent 判断何时该用我500 字符正文instructions具体操作指南50,000 字符任何缺少name或description的 SKILL.md 都会在扫描阶段被静默跳过不会出现在技能列表里。ID 由名称自动生成小写、连字符分隔见 SkillStore.suggestedID重名时自动追加-2、-3。Agent 如何发现并使用技能两级加载技能系统的设计精髓是渐进式披露避免把大量指令塞爆上下文索引常驻启动时Agent 的系统提示词里只注入一行式技能目录——每条格式为- id: description由 SkillStore.skillIndex 生成并经 AgentInstructions.skillsSection 拼装进提示词按需加载当任务与某条描述匹配时Agent 会调用read_skill(id)拉取完整正文然后严格按步骤执行。也就是说description不是给人看的备注而是 Agent 的路由关键词——写好它技能才容易被触发。进阶玩法你甚至不需要打开设置面板直接在聊天里说帮我把刚才的调色步骤存成一个技能Agent 就会调用manage_skills工具action 支持 create / update / remove见 ToolExecutorSkills.swift替你创建或修改技能。设置面板Installed 与 Community 双栏管理打开 设置 → Skills你会看到两个页签SkillsPane.swiftInstalled本机已装技能。每行带状态徽标——Local纯本地、Community与目录一致、或带 Update 按钮目录有新版本Community社区技能市场的浏览与安装入口支持搜索、一键安装、删除带确认框。面板右上角还提供两个高频操作Open Skills Folder直接在访达打开~/.palmier/skills/和Refresh Community Skills手动拉取最新目录。新建技能时会自动填入 内置模板包含 name、description 和 Workflow 骨架复制改写即可上手。社区技能市场catalog.json 与内容哈希技能市场的核心是社区仓库中的catalog.json每条记录只有五个字段SkillCatalogEntry字段作用id/name/description展示与检索pathSKILL.md 在仓库中的相对路径shaSKILL.md 的内容哈希前 12 位版本锚点安装流程SkillStore.install做了几道安全校验下载内容必须与目录声明的sha完全一致哈希用 SHA-256 前缀计算见 sha12、必须是合法 UTF-8、frontmatter 必须完整、ID 必须是单级安全路径防路径穿越。任何一项不过关安装直接拒绝。自动更新机制三种状态一套规则每次打开技能面板performSkillSync 会静默执行刷新目录 → 逐条比对 → 决定动作。决策逻辑浓缩在 shouldAutomaticallyInstall 一个纯函数里规则非常清晰你的本地状态目录新版本系统动作从未装过—自动安装首次触达即预装已装且本地文件没改过有✅ 自动更新到新版已装但改过community_modified有⏸️ 保持你的版本绝不覆盖已删除过进入 suppressed 名单有❌ 永不再自动装回被删除的技能会被记入.installed.json账本的suppressed集合保证删了就删了而你对社区技能做的任何修改都会让状态变为community_modified更新权完全交回给你——这是很多用户最在意的不被强制覆盖保障。分发你的技能如何进入社区市场想让工作流被更多人用上流程只有两步写好 SKILL.mddescription用一句话讲清什么场景下该用正文按 Workflow 分步骤描述可直接引用编辑器内已有的工具与面板名称提交到社区 palmier-skills 仓库放入独立路径并在catalog.json追加一条记录。sha用 SKILL.md 的内容哈希前 12 位生成即可——用户端会自动完成校验与版本比对。之后所有装有该技能的客户端会在下次打开技能面板时静默收到更新提示或自动升级。测试技巧SkillCatalog.base支持用环境变量PALMIER_SKILLS_BASE覆盖目录源指向本地克隆file://URL 可直接读取适合发布前用本地目录验证 catalog.json 是否正确SkillCatalog.swift。跨工具复用把技能复制到 Claude / Codex / Cursor技能系统采用开放的 SKILL.md 格式因此可以一键导出到其他编码/创作 AgentSkillStore.copy 会把技能复制到对应目录~/.claude/skills/、~/.codex/skills/、~/.cursor/skills/并自动加palmier-前缀确保只覆盖自己之前的副本、不碰第三方技能。新手常见问题QSKILL.md 写了为什么看不到技能A多半是 frontmatter 缺name或description或 ID 文件夹命名不合法。重新保存后在面板刷新即可。Q本地修改后还能更新吗A能但不会自动覆盖。在 Installed 页签中手动点 Update 才会拉取新版。Q一个技能可以带多个文件吗A可以技能就是一个文件夹SKILL.md 之外可放任意参考资料供正文引用。总结Palmier Pro 的技能系统把教会 AI 剪辑这件事降到了最低门槛一份带 frontmatter 的 Markdown即插即用社区市场用内容哈希保证版本可信、更新可控配合跨 Agent 导出你的工作流一次编写、处处复用。从写第一份 SKILL.md到发布进 catalog.json全程无需写一行 Swift。【免费下载链接】palmier-promacOS video editor built for AI项目地址: https://gitcode.com/GitHub_Trending/pa/palmier-pro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考