用 OK Skills 一次性装好 31 个跨 agent 编码技能

规划文件、查文档、浏览器自动化——这三件事你可以在每个项目里重新给 agent 写提示词，也可以一次性装成 skill。被 Awesome Codex CLI 收录、455 星的 ok-skills 精选合集，把 31 个技能目录打包成一条克隆命令，另附一份把它们接进 agent 配置的 playbook。

为什么这个 Skill 重要

这个仓库为 Codex、Claude Code、Cursor、OpenClaw、Autohand Code、Trae 及其他 SKILL.md 兼容工具，收集精选的 AI 编码 agent skills 和 CLAUDE.md / AGENTS.md playbook。README 里「31 个可复用技能」的说法经得起核对：仓库确实有整整 31 个顶层技能目录（2026 年 9 月 15 日清点），全部由该仓库维护。

README 的起步三件套覆盖了杠杆最高的习惯：planning-with-files（用 task_plan.md、findings.md、progress.md 做持久化规划，预计 5 次以上工具调用的任务都适用）、find-docs（通过 Context7 CLI 查最新库文档和 API 参考）、agent-browser（面向截图、表单、抓取和 Web QA 的浏览器自动化）。更大的索引横跨研究与文档、规划与提示、自动化与 QA、前端设计；README 的常用场景一行还列出了代码库理解和 PDF、Word、PPTX、XLSX 的文档创作。

全局指令方面，CLAUDE_AGENTS.md 打包了一套中文优先、KISS 导向的工作流——最新文档与源码检查、多 agent 优先、默认启用 planning-with-files 和 karpathy-guidelines、严格 TypeScript 约束、context-mode 路由规则——设计上就是复制或合并进 Claude Code 的 CLAUDE.md 或 Codex 的 AGENTS.md。

安装

文档记载的快速开始是克隆到 ~/.agents/skills：

mkdir -p ~/.agents/skills
cd ~/.agents/skills
git clone https://github.com/mxyhi/ok-skills.git ok-skills

Autohand Code 则按 README 文档另有两处克隆位置：用户级 ~/.autohand/skills 和项目级 .autohand/skills。

实战：把触发规则接进你的 agent

1. 克隆之后，把 README 的触发规则加进你的 AGENTS.md——或把同样的规则合并进 CLAUDE.md：

## Skills

- planning-with-files: Use for complex tasks, research, or anything that will take 5+ tool calls.
- find-docs: Use when you need current library docs, API references, or Context7-backed examples.
- agent-browser: Use for browser automation, screenshots, scraping, web testing, or form filling.

2. 然后按 README 的说法自然地提出要求：Use planning-with-files before refactoring this module.、Use find-docs to fetch the latest docs for this SDK. 或 Use agent-browser to reproduce this UI bug.
3. Claude Code 或 Codex 的全局指令可以从 CLAUDE_AGENTS.md 起步，复制或合并进 CLAUDE.md / AGENTS.md，复用前先按项目编辑其中的 语言要求 小节。

技巧

• 很多 skill 是从上游引入的，来源都有记录——planning-with-files 以 OthmanAdi/planning-with-files 为规范基线，索引表的 Source URL 列会指向引入技能的上游。
• 逐 skill 检查前置条件：有些假定 gh 已安装并登录；浏览器系 skill 可能需要 Chrome/CDP 环境；diagram-design 的 PNG 导出需要 Playwright 和 Chromium（pip install playwright && playwright install chromium）。
• 贡献规则让触发条件保持诚实：显式且可测试的触发条件、简洁且面向执行的示例、外部依赖写进 SKILL.md。

何时不用这个 Skill

playbook 是中文优先的——中文项目直接可用，其他语言的项目先改 语言要求 小节再采纳。这个合集刻意把众多上游镜像到一处；如果你依赖某个 skill 的演进，顺着它的 Source URL 直接跟踪上游。克隆式安装会把 31 个目录放到你机器上——只需要一两个的话，复制那几个目录就好，不必给全部接上触发规则。

查看排行榜了解更多 skill。