本文へ移動
cccskills
無料GitHub で公開

skill-creator-jp

Create new Claude Code Agent Skills in Japanese with proper SKILL.md format, trigger design, and evaluation methods. Triggers on requests for スキル作成, 新しいスキルを作る, SKILL.md作成, Agent Skill テンプレート, スキルの書き方.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md9.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

日本語スキル作成ガイド

概要

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-soudan3パターンの使い分け状況別ガイドラインの設計
code-review-jp重要度・カテゴリの分類構造化されたフィードバック設計
proposal-doc-jp企画書テンプレートビジネス文書のテンプレート設計

生成時の確認事項

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

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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

algorithmic-art-jp

無料日本語概要

Japanese algorithmic and generative art skill covering traditional pattern generation (wagara), calligraphy simulation, zen garden generators, and mathematical patterns from Japanese art. Triggers on requests for 和柄生成, ジェネラティブアート, アルゴリズミックアート, 伝統紋様パターン, Japanese generative art.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

article-writer-jp

無料日本語概要

Japanese tech article writer with non-duplicate H2/H3 structure design, content generation, and image TODO placeholders. Triggers on requests for 記事作成, 記事を作って, 記事を書いて, 〇〇の記事, テック記事, 解説記事, ブログ記事作成.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

canvas-design-jp

無料日本語概要

Japanese-inspired canvas and graphic design skill for HTML5 Canvas and SVG, covering traditional aesthetics (ma, wabi-sabi, yugen), calligraphy, washi textures, traditional patterns, and seasonal motifs. Triggers on requests for 和風デザイン, Canvas描画, SVGイラスト, 日本画風, Japanese-inspired graphics.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

doc-coauthoring-jp

無料日本語概要

Japanese document co-authoring and editing assistant with proofreading checklist, keigo adjustment, essay structure patterns (起承転結, PREP), and revision tracking. Triggers on requests for 文章推敲, 共同執筆, 文章校正, 敬語調整, 文体統一, レビュー依頼, ドキュメント編集.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

docx-jp

無料日本語概要

Generate Japanese Word documents (.docx) using python-docx with proper Japanese fonts, vertical writing (縦書き), ruby text (ふりがな), and business templates. Triggers on requests to create Word文書, 見積書docx, 請求書docx, 日本語Word, 縦書き文書, ビジネス文書Word.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

frontend-design-jp

無料日本語概要

Japanese frontend and web design skill covering typography, vertical writing, form handling, accessibility (JIS X 8341-3), and common Japanese UI patterns. Triggers on requests for 日本語Webデザイン, フロントエンド, 和文タイポグラフィ, Japanese web design.

LinkX-Japan/ai-souken-workflows62026年3月12日 更新

LinkX-Japan のスキルをすべて見る

このスキルの問題を報告する