codex-skills
轻量CLI工具，路由任务到对应AI技能手册
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：codex-skills。 它的用途是：轻量CLI工具，路由任务到对应AI技能手册 完整的 Skill 内容见：https://321skill.com/skills/codex-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我匹配适合编写前端设计规范的技能，展示前3个相关选项’，它会调用codex-skills的pick命令筛选最相关技能并展示概要。
对AI说：‘展示my-new-skill技能的详细操作手册’，它会调用show命令输出该技能的完整操作指引供执行参考。
介绍
AI Agent执行任务时，常缺乏标准化的分场景操作指引，零散的技能手册管理困难，手动匹配任务对应技能的效率低下，codex-skills正是为解决这一问题设计，它将各类技能的操作流程统一为标准化的Markdown手册，实现任务到技能的自动路由。 安装完成后，可通过简单的CLI命令完成技能目录初始化、可用技能列表查询，支持根据任务描述匹配最相关的Top N技能，也可查看指定技能的详细操作手册；既支持默认的本地skills目录，也可通过参数或环境变量自定义技能存储路径。 适合频繁使用AI Agent处理开发、设计类任务的开发者、设计师，以及需要统一管理AI技能流程的技术团队，尤其是拥有大量私有操作规范、需要定制AI执行逻辑的用户。 使用时需注意全局参数必须放在子命令之前，初始化时添加—force参数会写入内置示例技能，但不会覆盖路径不冲突的自定义技能；新增技能后可通过list和show命令验证加载状态，避免因路径或格式问题导致技能无法识别。
核心特点
不同于单一功能的AI技能，它是轻量的技能路由CLI，采用标准化Markdown文件管理技能手册，支持递归扫描自定义目录，无需修改核心代码即可扩展私有技能库。
注意事项
仅支持SKILL.md格式的文本类技能手册，本身不具备AI推理能力，仅负责技能匹配与指引输出。
常见问题
执行命令时提示'unexpected argument '--skills-dir''怎么办？
需将--skills-dir这类全局参数放在子命令之前，也可通过设置SKILLS_DIR环境变量指定技能目录。
新增技能后list命令无法识别怎么办？
请检查SKILL.md文件是否存放在指定的skills目录下且权限可读，可通过--skills-dir参数明确指定技能目录路径。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/codex-skills/raw/index.md 读取 codex-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/codex-skills/raw/index.md（查看排版版本）