用 skill-share 打通 Codex 技能创建与 Slack 团队分享的自动化管线【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本指南以 awesome-codex-skills 仓库中的 skill-share 技能 为核心讲解如何让 Codex 一键完成「技能创建 → 结构校验 → 打包分发 → Slack 团队广播」的完整闭环。读完本文你将掌握标准技能目录结构、frontmatter 元数据规范、基于 Rube MCP 的 Slack 集成方式并能结合仓库内 skill-creator 的脚本与 quick_validate.py 的校验规则搭建一条可复用的团队技能生产线。何时该使用 skill-shareskill-share 面向的场景非常明确当一个团队需要持续产出、沉淀并分发 Codex/Claude 技能时。它把「写技能」和「通知团队」两件事合并成一次会话完成。官方文档列出的触发条件包括创建新的技能需要按规范生成目录结构与元数据的完整技能包生成可分发的技能包产出 zip 或.skill格式的分发文件自动同步到 Slack 频道让团队成员第一时间发现新技能校验技能结构在分享前确认 SKILL.md 格式与字段完整打包并向团队分发把技能整理成标准格式供其他人安装。从使用方式看它最适合三类落地场景团队工作流内建技能技能不再只存在于个人~/.codex/skills而是作为团队资产被统一创建、校验和分发内部工具链需要「技能创建 团队通知」强耦合的自动化管道协作式技能开发每次创建技能都同步广播给全员降低发现成本。值得注意的一点是该技能在底层复用了仓库中 skill-creator 一整套创建/校验/打包工具因此它本质上是一个编排层把零散的 CLI 脚本和 Slack 消息能力编排成一次对话即可完成的端到端流程。四大核心能力拆解1. 技能创建skill-share 要求按标准结构创建技能目录这与仓库中 skill-creator 定义的 Anatomy of a Skill 完全一致skill-name/ ├── SKILL.md # 必需YAML frontmatter Markdown 指令 ├── scripts/ # 可选可执行脚本Python/Bash 等 ├── references/ # 可选按需加载的参考资料 └── assets/ # 可选输出中用到的模板/字体/图片等创建阶段会自动生成 YAML frontmatter并强制遵守hyphen-case 命名规范。这条规则在 quick_validate.py 中有硬性约束名称必须匹配正则^[a-z0-9-]$不能以连字符开头或结尾不能出现连续连字符且长度上限为 64 字符。从源码实现看目录创建由 init_skill.py 完成它会把用户输入的名称自动规范化转小写、非字母数字统一替换为连字符、折叠重复连字符再生成带 TODO 占位符的 SKILL.md 模板并可选地创建scripts/、references/、assets/三个资源目录。2. 技能校验打包与分享之前必须先过校验关这正是 quick_validate.py 承担的工作。它逐项检查frontmatter 存在且格式正确文件必须以---开头frontmatter 必须是合法的 YAML 字典允许的属性白名单仅允许name、description、license、allowed-tools、metadata五个键出现其他键直接报错name与description为必填缺失即失败名称规范hyphen-case 格式、长度 ≤ 64、无非法连字符描述质量不能包含尖括号、长度上限 1024 字符。校验失败时脚本会输出具体错误信息并以非零码退出只有全部通过才会进入打包环节。3. 技能打包打包由 package_skill.py 完成。它的执行逻辑是先校验、后打包调用validate_skill()确认技能合法然后使用 Python 标准库zipfile将整个技能目录压缩为.skill文件本质是扩展名换掉的 zip。压缩时会以技能目录的父目录为基准计算相对路径file_path.relative_to(skill_path.parent)从而在压缩包内完整保留原有目录结构便于分发后直接解压安装。4. 基于 Rube 的 Slack 集成分享环节依赖Rube完成 Slack 集成。Rube 是一个 MCPModel Context Protocol服务端以RUBE_SEARCH_TOOLS等工具的形式向 Agent 暴露 Slack 操作能力。skill-share 具体用到的三个工具是Rube 工具用途SLACK_SEND_MESSAGE向团队频道发送技能信息SLACK_POST_MESSAGE_WITH_BLOCKS以富文本 block 形式分享格式化的技能元数据SLACK_FIND_CHANNELS发现/查找用于技能公告的目标频道在仓库的 slackbot-automation 技能中可以看到同类集成的前提需要在客户端配置中添加 Rube MCP 端点作为 MCP 服务器无需 API Key连接后即可调用 Slack 相关工具。这与 skill-share 文档声明的「Slack workspace connection via Rube」相互印证。端到端工作流程skill-share 定义的流程是一条清晰的五步流水线初始化提供技能名称与描述创建生成符合规范结构的技能目录校验验证技能元数据的正确性与完整性打包将技能打包为可分发的.skill文件Slack 通知将技能详情发布到团队 Slack 频道。文档给出的完整示例是创建名为pdf-analyzer的技能1. 创建 /skill-pdf-analyzer/ 目录写入 SKILL.md 模板 2. 生成结构化子目录scripts/、references/、assets/ 3. 校验技能结构 4. 将技能打包为 zip 文件 5. 发布到 SlackNew Skill Created: pdf-analyzer - Advanced PDF analysis and extraction capabilities这个流程在源码层面是真实可执行的步骤 1–2 对应 init_skill.py 的init_skill()函数创建目录 生成模板 按需建资源目录步骤 3 对应 quick_validate.py 的validate_skill()步骤 4 对应 package_skill.py 的package_skill()。也就是说你在会话里下达指令后Agent 会依次调用这些脚本并最终通过 Rube 完成广播。创建与打包的实操命令如果你希望脱离 Agent 手动复现 skill-share 的内部步骤可以直接使用 skill-creator 提供的脚本。初始化一个技能对应流程步骤 1–2# 基本用法创建 my-skill 目录与 SKILL.md 模板 python skill-creator/scripts/init_skill.py my-skill --path skills/public # 指定资源目录 python skill-creator/scripts/init_skill.py my-skill --path skills/public --resources scripts,references # 额外生成示例文件脚本、参考文档、资产占位 python skill-creator/scripts/init_skill.py my-skill --path skills/public --resources scripts --examples脚本会拒绝覆盖已存在的目录并在名称过长64 字符或非法时报错退出。生成后需手工编辑 SKILL.md 完成 TODO 占位内容。独立校验技能python skill-creator/scripts/quick_validate.py path/to/skill-directory打包为.skill分发文件对应流程步骤 4内置自动校验# 输出到当前目录 python skill-creator/scripts/package_skill.py path/to/skill-directory # 指定输出目录 python skill-creator/scripts/package_skill.py path/to/skill-directory ./dist校验未通过时打包会中止不会生成.skill文件。分享给团队后的安装闭环技能广播到 Slack 只是起点团队成员的安装环节由仓库中的 skill-installer 技能承接形成完整闭环。两种安装方式见 README.md推荐使用安装脚本从 GitHub 仓库或精炼列表安装到$CODEX_HOME/skills默认~/.codex/skills手动安装将技能目录复制到$CODEX_HOME/skills/后重启 Codex。安装完成后必须重启 Codex使其重新加载元数据。之后在会话中自然描述任务即可触发技能——Codex 依据 SKILL.md frontmatter 中的description决定何时加载技能这正是 skill-share 在创建阶段强制要求「description 必须完整、清晰」的根本原因。从 skill-creator 的设计理念看description是技能唯一的触发机制因此文档明确建议把「何时使用」的全部信息写入 frontmatter而非正文。运行前置条件skill-share 的文档明确了四项要求缺一不可Slack 工作区连接通过 Rube 建立连接需在客户端配置 Rube MCP 服务器技能创建目录的写权限Agent 需要能落盘生成技能目录与文件Python 3.7创建/校验/打包脚本均基于 Python 实现且依赖 PyYAMLimport yaml见 quick_validate.py目标 Slack 频道提前指定技能公告要发送到哪个频道供SLACK_FIND_CHANNELS定位与SLACK_SEND_MESSAGE发送。实践要点与注意事项description 是命门它在 frontmatter 中承担触发职责校验脚本还要求其长度 ≤ 1024 且不含尖括号。创建技能时应写清楚「做什么 何时用 触发场景」而不是放空泛宣传语。保持技能目录精简仓库文档明确反对在技能目录内放置 README、CHANGELOG 等额外文档技能只应包含让 Agent 完成任务所必需的文件详见 skill-creator/SKILL.md。渐进式披露SKILL.md 正文保持精简500 行详细内容拆到references/按需加载复杂脚本放进scripts/可执行而不占用上下文窗口。分享前必校验.skill打包前会自动校验宁可先跑quick_validate.py修复问题也不要等 Slack 广播后才发现包是坏的——那会让整个团队拿到不可用的技能。模板起步如果是从零写技能可参考仓库内的 template-skill 极简模板再结合 skill-share 的创建流程快速产出符合规范的技能包。至此一条「创建 → 校验 → 打包 → Slack 广播 → 成员安装」的团队技能管线已经完整打通skill-share 负责编排与通知skill-creator 的脚本提供可执行的底层实现skill-installer 完成分发安装。这套组合让技能沉淀从个人行为升级为可持续的团队工程实践。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考