コーディング不要の、ブラウザのワークフローを再利用可能なAIエージェントスキルへ変換する完全ガイド。
SKILL.mdファイルとは？
SKILL.md は、AIエージェントの能力を定義する標準フォーマットとして浮上しています。Claude Code、OpenAI Codex、Goose、その他のエージェントフレームワークで使用され、それは次の点を説明します：
- 何を達成するか（目標）
- どうやるか（段階的な手順）
- 必要なもの（文脈/要件）
- 何が問題になる可能性があるか（エラーハンドリング）
- 出力（出力形式）
従来、これらのファイルを作成するには、すべての手順を手動で文書化する必要があり、骨の折れる作業であり、誤りが発生しやすいものでした。しかし、より良い方法があります。
従来の方法と新しい方法
従来の方法（手動）
- 作業を実行しながらノートを取る
- 詳細な手順を書き出す
- エージェントに適したSKILL.md形式を見つける
- テスト、デバッグ、反復
- UIの変更時に更新する
所要時間: 複雑なワークフローの場合は2〜4時間
新しい方法（自動化）
- Record ワークフローを実行している画面を録画する
- Extract — AIが録画を分析してSKILL.mdを生成する
- Deploy — スキルをエージェントのディレクトリに追加する
所要時間: 2-3分
ステップバイステップ: 画面録画からSKILL.md
ステップ1: ワークフローを録画する
タスクを実行するウェブアプリに移動します。録画を開始し、自然な流れでワークフローを進めます:
- ボタンやリンクをクリック
- フォームに入力
- ページ間を移動
- 確認ダイアログやポップアップを処理
コツ: 通常通りの手順で作業を行ってください。AIはあなたの自然なワークフローから学習します。
ステップ2: AI抽出
抽出エンジンは、以下を用いて録画を分析します:
- コンピュータビジョン — UI要素、ボタン、フォームを識別
- DOM分析 — 頑健なCSSセレクターを生成
- シーケンス理解 — アクションの順序をマッピング
- 文脈推論 — エージェントに必要な情報を判断
出力は、Anthropic SKILL.md仕様に従った、完全で構造化された SKILL.md ファイルです。
ステップ3: あなたのエージェントへデプロイ
生成されたスキルを、エージェントのスキルディレクトリに配置します:
# Claude Code向け
~/.claude/skills/onboarding-flow/SKILL.md
#
返却形式: {\"title_ja\": \"...\", \"summary_detail_ja\": \"...\", \"content_ja\": \"...\"}
本文がない場合は空文字にしてください。詳細サマリは箇条書き（- で始まる行）の形式を保持してください。
