OK Skills – 可复用的 AI 智能体「技能」，适用于 Codex、Claude Code、Cursor、OpenClaw 等

这是什么 – 一个精选的 31 个 技能 目录集合，可放入 ~/.agents/skills/ok-skills 文件夹（或等效的 Autohand Code 位置）。每个技能都是一组自包含的指令（SKILL.md）和 AI 编码助手可以调用的辅助脚本。该仓库还附带一个 CLAUDE_AGENTS.md 操作手册，可以合并到工具的 CLAUDE.md / AGENTS.md 文件中，为智能体提供现成的功能菜单。

适用人群 – 已经使用 AI 编码智能体（Codex、Claude Code、Cursor、OpenClaw、Autohand Code、Trae 等）并希望拥有经过实战检验、即插即用的操作库，而不是每次都编写临时提示词的开发者。对于维护共享 AGENTS.md 工作流并需要可移植、版本控制的技能定义的团队也很有用。

如何开始

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

或者 克隆到 Autohand Code 的技能文件夹（~/.autohand/skills 或 .autohand/skills）。克隆后，目录结构已经与智能体期望的一致：

~/.agents/skills/ok-skills/
  CLAUDE_AGENTS.md
  planning-with-files/SKILL.md
  find-docs/SKILL.md
  agent-browser/SKILL.md
  …

将技能名称添加到你的 AGENTS.md（或 CLAUDE.md）的 Skills 部分，例如：

## Skills
- planning-with-files: 用于复杂的多步骤任务
- find-docs: 获取最新的库文档
- agent-browser: 自动化浏览器、截图、抓取页面

然后你可以直接要求智能体：

“在重构此模块之前，使用 planning-with-files。” “使用 find-docs 获取最新的 SDK 文档。” “使用 agent-browser 重现这个 UI 错误。”

内部内容 – 技能按常见用例分组：

• 研究与文档 – find-docs、exa-search、get-api-docs、ax。
• 规划与提示 – planning-with-files、autoresearch、diagnosing-bugs、karpathy-guidelines、tdd。
• 自动化与 QA – agent-browser、kimi-webbridge、browser-trace、opencli。
• 前端与设计 – ai-elements、huashu-design、imagegen-frontend-web、gpt-taste、better-icons、diagram-design。
• 工具与创作 – 用于图标查找、图表生成等的各种辅助工具。

每个技能的 SKILL.md 包含：

• 简短描述和何时调用。
• 所需的外部工具（例如，gh 身份验证、用于浏览器工作的 Chrome/Playwright、pip install playwright）。
• 可以复制到全局智能体配置中的触发规则。

为什么重要 – AI 编码智能体的价值取决于它们能调用的工具。通过提供标准化、版本控制的技能集，ok-skills 让团队能够共享最佳实践工作流（例如，“plan-with-files → fetch docs → run browser automation”）而无需每次重新发明提示词。仓库还跟踪每个技能的上游来源，因此可以从原始项目拉取更新，同时保持本地布局稳定。

前提条件 – 大多数技能假设你具有：

• 已安装目标 AI 编码智能体（Codex、Claude Code 等）。
• 最新的 git，以及许多与浏览器相关的技能还需要一个支持 Chrome DevTools 协议（CDP）的 Chrome/Chromium 环境。
• 各个 SKILL.md 文件中注明的可选 CLI（gh、exa、Context7 等）。

---

所有细节均直接取自仓库的 README；没有推断其他功能。