OpenClawカスタムスキル開発実践：ゼロから画像処理Skillを作る完全ガイド

週末の午後、私はパソコンの画面を見つめていました。フォルダにはスマホから取り込んだ127枚の写真が入っており、どれも5MB以上あります。OpenClawに「一括圧縮して」と頼んだところ、ImageMagickのコマンドリストが返ってきて、「これをコピペして実行してください」と言われました。

正直、その時こう思いました。「このプロセスをOpenClawが『覚えて』くれれば、次回『画像を圧縮して』と言うだけでやってくれるのに」と。

後で知りましたが、OpenClawにはまさにこのニーズに応える機能がありました——カスタムSkill（スキル）を作成することで、あなた専用のワークフローを教え込むことができるのです。iPhoneにアプリを入れるように、一度インストールすればずっと使えます。

Railway - モダンなデプロイプラットフォーム、煩わしい運用から解放、数分で公開

今すぐ始める →広告

この記事では、完全な画像処理スキルを例に、開発の全工程をゼロから解説します。

Skillの本質を理解する（5分で分かる）

そもそもSkillとは？

初めて「Skill」という言葉を見た時、私の頭には技術用語が飛び交いました。プラグイン？ 拡張機能？ ミドルウェア？ どれも少し違います。

簡単に言うと、SkillとはClaudeにインストールする「専用アプリ」です。

OpenClawの標準機能で日常タスクの80%はこなせますが、残りの20%——例えば会社独自の画像処理フローや、あなた個人のファイル命名規則など——には、自分で「アプリを入れる」必要があります。

Skillの構成要素

完全なSkillの構造はシンプルで、主に3つの部分から成ります：

1. SKILL.md（必須）：設定ファイル。このスキルが何をするもので、いつ使うべきかをClaudeに教えます。
2. scripts/ フォルダ（任意）：実際に動作するスクリプトコード。PythonやBashなどが使えます。
3. references/ フォルダ（任意）：補足説明ドキュメント。例えば対応ファイル形式リストなど。

今回作る画像処理スキルのディレクトリ構成はこうなります：

~/.claude/skills/image-processor/
├── SKILL.md              # コア設定ファイル
├── scripts/
│   └── compress.py       # 画像圧縮スクリプト
└── references/
    └── formats.md        # 対応フォーマット説明

なぜカスタムSkillが必要なのか？

カスタムSkillの価値は、繰り返されるプロセスを固定化し、一度の設定で一生使えるようにする点にあります。

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

Skillの動作原理（Progressive Disclosure）

この仕組みは非常に賢く設計されています。Claudeは最初から全スキルの詳細説明をメモリに読み込むわけではありません（トークンの無駄だからです）。代わりに3段階で読み込みます：

1. 第1層（Frontmatter）：スキルの名前と短い説明だけを見て、「今のタスクにこのスキルは必要か？」を判断します。
2. 第2層（Body）：必要と判断されたら、詳細な使用説明を読み込みます。
3. 第3層（Scripts）：実際に実行する段階になって初めて、スクリプトファイルを呼び出します。

個人レベル vs プロジェクトレベル

• 個人レベル：~/.claude/skills/技能名/ —— 全てのプロジェクトで使用可能
• プロジェクトレベル：プロジェクトルート/.claude/skills/技能名/ —— そのプロジェクト内でのみ有効

私のお勧めは、まず個人レベルで作ってみて、使い勝手が良ければプロジェクトごとの隔離を検討することです。

画像処理Skill作成の完全フロー

ステップ1：フォルダ構造の作成

まずフォルダを作ります。どこでも使えるように個人ディレクトリに作成しましょう：

mkdir -p ~/.claude/skills/image-processor
cd ~/.claude/skills/image-processor
mkdir scripts references

ステップ2：SKILL.md設定ファイルの作成

これがスキルの心臓部です。SKILL.md を作成し、以下を入力します：

---
name: image-processor
description: 画像一括処理ツール。ユーザーが画像の圧縮、フォーマット変換、サイズ変更、透かし追加を必要とする場合に使用。JPG, PNG, WebP形式をサポート。
tools: Bash, Read, Write
---

この3行のYAMLが重要です：

• name：スキルの識別子。ユーザーは /image-processor で手動呼び出しも可能です。
• description：この一行が、Claudeがいつこのスキルを自動トリガーするかを決定します。
• tools：必要な権限を宣言します。

ステップ3：Pythonスクリプトの開発

scripts/compress.py を作成します。これが実働部隊です。冒頭の要件通り、圧縮、変換、リサイズに対応させます。

Alibaba Cloud - 開発者向けクラウドの第一候補、ライトサーバー15%OFF、プロジェクトの迅速な立ち上げを支援

15%割引を入手 →広告

（紙幅の都合上、コード全体はGitHubの例を参照してください。基本ロジックはPillowライブラリを使用した画像処理です）

ステップ4：補足ドキュメントの追加（任意）

スキルをより完璧にするために、references/formats.md に対応フォーマットの詳細などを記述します。

テストとデバッグのコツ

方法1：明示的な呼び出しテスト

最も簡単なテスト方法は、Claude Code内で直接入力することです：/image-processor

方法2：自動トリガーテスト

画像が入ったフォルダを用意し、Claudeにこう言ってみましょう：「~/Downloads/photos フォルダの画像を圧縮して」

方法3：実行ログの確認

スクリプトが失敗した場合、ターミナルの出力を確認してエラーメッセージを特定します。

セキュリティとベストプラクティス

セキュリティ設定の3原則

1. 最小権限：本当に必要なツールだけを宣言する。tools: * は避ける。
2. 入力検証：スクリプト内でユーザー入力をチェックし、不正なパラメータを防ぐ。
3. パス制限：スクリプトがシステムの機密ディレクトリにアクセスしないようにする。

性能最適化のアドバイス

• Progressive Disclosureの活用：descriptionは短く的確に。
• キャッシュ戦略：頻繁に読む設定はSKILL.md内に直接書く。

まとめ

要点は3つだけです：

1. SkillはClaude専用アプリ——SKILL.mdで「何をするか、いつ使うか」を教えます。
2. 開発は簡単——ディレクトリ作成、設定、スクリプト（任意）、この3ステップです。
3. 小さく始める——最初から完璧を目指さず、具体的な悩みを1つ解決できれば成功です。

いざ、実行

読み終わって終わりにしないでください。今すぐ手を動かしましょう：

1. コードをコピーする
2. テストしてみる
3. 自分用に改造する

30分後には、あなただけの最初のOpenClawスキルが動いているはずです。

参考リソース

• OpenClaw Skill Development Guide
• Python Pillow Library

3 min read · 公開日: 2026年2月5日 · 更新日: 2026年2月5日

Easton

AI・インテリジェンス