johnalbertini14-glitch Skill Creator - OpenClaw Skills Best Practices
OpenClaw用のスキルを作成するためのガイド。公式ベストプラクティスに基づく。
ワークフロー
Phase 1: ユースケース定義
ユーザーに2-3個の具体的なユースケースを聞く:
このスキルでどんなワークフローを実現したいですか？
例:
ユースケース: [名前]
トリガー: ユーザーが「[具体的なフレーズ]」と言った時
ステップ:
1. [最初のアクション]
2. [次のアクション]
結果: [期待する成果]
Phase 2: Frontmatter生成
必須フィールド:
name: kebab-case、最大64文字、フォルダ名と一致description: WHAT + WHEN + トリガーフレーズ、最大1024文字
オプションフィールド:
auto_trigger: true/false（自動起動するか）allowed-tools: ツールアクセス制限metadata: author, version等
description の書き方:
[何をするか]. [主な機能]. Use when user says "[trigger1]", "[trigger2]", "[trigger3]", or [一般的な状況].
良い例:
description: Analyzes design files and generates documentation. Use when user says "design specs", "component docs", or needs design handoff.
悪い例（避ける）:
# 曖昧すぎる
description: Helps with projects.
# トリガーがない
description: Creates sophisticated documentation systems.
Phase 3: 指示を書く
構造テンプレート:
# [スキル名]
## 目的
[このスキルが何をするか1-2文]
## 手順
### Step 1: [最初のステップ]
何が起こるかの明確な説明。
例:
\`\`\`bash
[コマンド例]
\`\`\`
### Step 2: [次のステップ]
...
## 例
### 例1: [一般的なシナリオ]
ユーザー: "[リクエスト例]"
アクション:
1. [アクション1]
2. [アクション2]
結果: [成果]
## トラブルシューティング
### エラー: [よくあるエラー]
原因: [なぜ起こるか]
解決: [修正方法]
Phase 4: バリデーションチェックリスト
作成前に確認:
ファイル構造:
- フォルダ名がkebab-case
- SKILL.mdファイルが存在
- スキルフォルダにREADME.mdがない
Frontmatter:
-
---デリミタがある -
name: kebab-case、スペースなし、大文字なし -
name: フォルダ名と一致 -
description: WHATとWHENを含む -
description: 1024文字以下 - XMLタグ（< >）がない
指示:
- 明確でアクション可能
- エラーハンドリングあり
- 例が含まれている
- 500行以下
Phase 5: スキル作成
# フォルダ作成
mkdir -p skills/[skill-name]
# SKILL.md作成
# （内容を書く）
# 確認
ls skills/[skill-name]/SKILL.md
禁止パターン
| パターン | 禁止理由 |
|---|---|
| スペース入りの名前 | 読み込めない |
| 大文字入りの名前 | 読み込めない |
| "claude"/"anthropic"で始まる名前 | 予約済み |
| frontmatterにXMLタグ | セキュリティリスク |
| スキルフォルダにREADME.md | 読み込み混乱 |
| descriptionにトリガーなし | 自動起動しない |
| 本文500行超 | パフォーマンス問題 |
クイックテンプレート
テンプレート1: ワークフロー自動化
---
name: [workflow-name]
description: [Xワークフローを自動化]. Use when user says "[trigger1]", "[trigger2]".
auto_trigger: true
---
# [ワークフロー名]
## 目的
[何を自動化するか]
## 手順
1. [Step 1]
2. [Step 2]
3. [Step 3]
テンプレート2: セキュリティスキャナー
---
name: [security-topic]-scanner
description: Detects [脆弱性タイプ]. Use when user says "[trigger1]", "[trigger2]".
auto_trigger: true
---
# [セキュリティトピック] Scanner
## 検出対象
1. [脆弱性1]
2. [脆弱性2]
## スキャン手順
[スキャン方法]
## 修正方法
[修正方法]
テンプレート3: SNS連携
---
name: [platform]-poster
description: Posts content to [platform]. Use when user says "[trigger1]", "[trigger2]".
auto_trigger: false
---
# [Platform] Poster
## 前提条件
- [認証情報が設定済み]
## ワークフロー
1. コンテンツ準備
2. 投稿
3. 結果確認
成功基準
スキル作成後にテスト:
- トリガー: 関連クエリで読み込まれるか？
- 機能: 正しい出力が得られるか？
- 過剰トリガーなし: 無関係なトピックで読み込まれないか？