mxyhi/ok-skills

Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, and other SKILL.md-compatible tools.

OK Skills – Codex、Claude Code、Cursor、OpenClaw などで再利用可能な AI エージェント「スキル」

概要 – ~/.agents/skills/ok-skills フォルダ(または同等の Autohand Code の場所)に配置できる、31 のスキルディレクトリのキュレーションコレクションです。各スキルは、AI コーディングアシスタントが呼び出せる自己完結型の指示(SKILL.md)とヘルパースクリプトで構成されています。リポジトリには、ツールの CLAUDE.md / AGENTS.md ファイルにマージできる CLAUDE_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 Protocol(CDP)が利用可能な Chrome/Chromium 環境。
  • 個々の SKILL.md ファイルに記載されているオプションの CLI(gh、exa、Context7 など)。

すべての詳細はリポジトリの README から直接取得されています。追加の機能は推測されていません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト