Skill creator jp

日本語スキル作成ガイド

概要

Claude Code Agent Skill を日本語で新規作成するためのガイドスキルです。SKILL.md の書き方、日本語トリガーの設計、スキルの評価方法を体系的に解説し、テンプレートを提供します。

スキルの構成要素

すべてのスキルは以下の要素で構成されます。

要素	必須	説明
name	はい	英語・小文字・ハイフン区切りのスキル識別名
description	はい	英語 + 日本語キーワードを含むトリガー説明文
概要	はい	スキルの目的と機能を日本語で説明
ルール・ガイドライン	はい	スキルが従うべきルールや基準
テンプレート	推奨	出力のフォーマット・構造
確認事項	推奨	生成前にユーザーに確認すべき項目
例・サンプル	任意	入出力の具体例（別ファイル推奨）

SKILL.md の書き方

ファイル構造

---
name: skill-name-here
description: English description + 日本語トリガーキーワード
---

# スキルタイトル（日本語）

## 概要
（スキルの目的と機能を2〜3文で説明）

## ルール・ガイドライン
（スキルが従うべきルール。表、箇条書き、コードブロックを活用）

## テンプレート
（出力フォーマットの定義）

## 生成時の確認事項
（ユーザーに確認すべき項目のリスト）

YAML フロントマターのルール

---
name: japanese-example-skill    # 英語、小文字、ハイフン区切り
description: >-
  English description of what the skill does.
  Triggers on requests for 日本語キーワード1,
  日本語キーワード2, 日本語キーワード3.
---

注意事項:

• name は英語のみ。スペースや日本語は使用しない
• description は英語の説明文を主体とし、末尾に日本語トリガーキーワードを含める
• description は Claude がスキルを選択する際の判断材料になるため、具体的に書く

日本語トリガー設計のベストプラクティス

description フィールドの設計

Claude がスキルを自動選択するため、description の質がスキルの活用度を決定します。

推奨パターン:

description: >-
  [英語で機能を1〜2文で説明].
  Triggers on requests for [日本語キーワードをカンマ区切りで列挙].

良い例:

description: >-
  Generate formal Japanese business emails with proper keigo and
  seasonal greetings. Triggers on requests for ビジネスメール,
  取引先メール, お礼メール, お詫びメール, 日程調整メール.

悪い例:

description: メールを書くスキル
# → 英語がない、キーワードが少なすぎる、具体性がない

トリガーキーワードの選び方

1. ユーザーが実際に使う言葉を選ぶ: 専門用語だけでなく、口語的な表現も含める
2. 類義語を網羅する: 同じ意味の異なる表現を複数含める
3. 具体的なシーンを含める: 抽象的な機能名より具体的なユースケース名
4. 5〜10個のキーワード: 少なすぎると漏れ、多すぎるとノイズになる

キーワード選定のチェックリスト:

• ユーザーが自然に使う動詞を含んでいるか（作って、書いて、生成して）
• 日本語の漢字表記とひらがな表記の両方を考慮したか
• 略称・通称があれば含めているか（例: 報連相、週報）
• 具体的な成果物名を含んでいるか（例: 議事録、企画書）

本文の書き方ガイドライン

原則

1. 本文は日本語で書く: YAML フロントマター以外はすべて日本語
2. 構造化する: 見出し・表・箇条書き・コードブロックを活用し、読みやすくする
3. 具体的に書く: 抽象的な指示ではなく、具体的なルール・テンプレートを提供する
4. 100〜130行を目安に: 短すぎると情報不足、長すぎると読み込み負荷が高い

セクション設計のコツ

セクション	コツ
概要	2〜3文で簡潔に。「〜するスキルです」で締める
ルール	表形式が効果的。判断基準を明確にする
テンプレート	コードブロックでフォーマットを定義。プレースホルダーは 【】 で囲む
確認事項	番号付きリストで5〜7項目。太字でキー項目を強調

プレースホルダーの規約

【会社名】  — ユーザーが埋める固有名詞
【日付】    — 日付情報
【自由記述】 — ユーザーが自由に記述する箇所

ディレクトリ構成

skill-name/
├── SKILL.md              # メインのスキル定義（必須）
├── examples/             # 入出力の具体例（任意）
│   ├── example-1.md
│   └── example-2.md
├── templates/            # テンプレートファイル（任意）
│   └── template-1.md
└── palettes/             # リソースファイル（任意）
    └── resource-1.md

• SKILL.md は必須。これがスキルのエントリポイント
• 補足ファイルは SKILL.md から相対パスで参照する
• ファイル名は英語・小文字・ハイフン区切り

テンプレート生成

以下のテンプレートをベースに新しいスキルを作成してください。

---
name: new-skill-name
description: English description of the skill purpose and capabilities. Triggers on requests for 日本語キーワード1, 日本語キーワード2, 日本語キーワード3.
---

# 【スキルタイトル（日本語）】

## 概要

【このスキルの目的と機能を2〜3文で説明してください。「〜するスキルです。」で締めてください。】

## 【ルール・ガイドラインのセクション名】

【スキル固有のルール、基準、判断表などを記載してください。表形式やコードブロックを活用すると効果的です。】

## テンプレート

【出力フォーマットをコードブロックで定義してください。プレースホルダーは【】で囲みます。】

## 生成時の確認事項

生成を開始する前に、以下をユーザーに確認してください：

1. **【確認項目1】**: 【説明】
2. **【確認項目2】**: 【説明】
3. **【確認項目3】**: 【説明】
4. **【確認項目4】**: 【説明】
5. **【確認項目5】**: 【説明】

不明な項目はプレースホルダー `【〇〇】` で表示してください。

日本語スキルの評価方法

評価チェックリスト

スキルを公開する前に、以下の項目を確認してください。

#	評価項目	確認内容
1	トリガーの正確性	想定するプロンプトでスキルが呼び出されるか
2	出力の品質	日本語として自然で、ビジネスに耐えうる品質か
3	敬語の正確性	敬語の使い分けが正しいか
4	テンプレートの実用性	テンプレートがそのまま業務に使えるか
5	プレースホルダー	未確定項目が 【】 で明示されているか
6	ファイルサイズ	100〜130行の適正範囲に収まっているか
7	参照の整合性	外部ファイルへのリンクが正しいか

テスト方法

1. 基本テスト: 想定トリガーでスキルが呼び出されることを確認
2. バリエーションテスト: 異なる言い回しでもトリガーされるか確認
3. 品質テスト: 生成された文書を日本語ネイティブに確認してもらう
4. エッジケーステスト: 情報不足の場合にプレースホルダーが適切に使われるか確認

既存の日本語スキル参考例

以下の既存スキルを参考にしてください。

スキル名	特徴	参考になるポイント
japanese-business-email	敬語ルール表、時候の挨拶表	表形式でのルール定義が秀逸
meeting-minutes-jp	テンプレート中心の構成	出力フォーマットの定義方法
houkoku-renraku-soudan	3パターンの使い分け	状況別ガイドラインの設計
code-review-jp	重要度・カテゴリの分類	構造化されたフィードバック設計
proposal-doc-jp	企画書テンプレート	ビジネス文書のテンプレート設計

生成時の確認事項

新しいスキルを作成する前に、以下を確認してください：

1. スキルの目的: 何を自動化・支援するスキルか
2. ターゲットユーザー: 誰が使うか（職種、スキルレベル）
3. トリガーキーワード: ユーザーがどんな言葉で呼び出すか
4. 出力形式: 生成物の形式（文書、コード、表など）
5. 補足ファイル: examples/ や templates/ が必要か
6. 既存スキルとの重複: 類似スキルがないか確認