Claude Code Skill設計10パターン|確実に発火するdescriptionと運用テンプレ
Claude CodeのSkillは便利だが、descriptionが曖昧だと発火しない。ZYL0 Blogの実運用を題材に、発火条件、品質ゲート、検証方法をAdSense品質基準も含めて整理する。

Claude CodeのSkillは便利だが、descriptionが曖昧だと発火しない。ZYL0 Blogの実運用を題材に、発火条件、品質ゲート、検証方法をAdSense品質基準も含めて整理する。
Claude CodeのSkillは、単なる便利メモではありません。私には、プロジェクトごとの「作業標準」をモデルに渡すための運用ルールに見えています。ZYL0 Blogでも投資記事、クリエイター記事、技術記事のSkillを分けていますが、最初はdescriptionが曖昧すぎて、期待した場面で呼ばれないことが何度もありました。
この記事では、実際のブログ運用で使っているSkill設計を題材に、発火しやすいdescription、壊れにくいSKILL.md、AdSense審査を意識した品質ゲートを10パターンに整理します。2026年5月時点のClaude Code、MCP、Subagent、Hook、Plan modeの役割分担を前提にしています。
Version note: 2026年5月時点のClaude CodeドキュメントとZYL0 BlogのローカルSkill運用を前提にしています。CLI仕様やSkillの挙動は変わる可能性があるため、実装時は公式ドキュメントで確認してください。
TL;DR:この記事でわかること
| テーマ | 実務で効くポイント |
|---|---|
| description | 「何をするか」より「いつ呼ぶか」を書く |
| trigger phrases | ユーザーが実際に入力する語を入れる |
| scope | Skill、Subagent、Hook、MCPの責務を混ぜない |
| quality gate | 記事生成では独自性、出典、免責を必須にする |
| validation | 生成後にビルドと軽量監査で確認する |
1. descriptionは自己紹介ではなくルーティング条件
最初に直すべき場所は、ほぼ必ずdescriptionです。
悪い例はこうです。
description: Write high quality blog posts.
これでは、どの読者向けなのか、どんな依頼文で呼ぶのか、どこに保存するのかが見えません。私が安定したと感じた型は次です。
description: >
Write bilingual Japanese and English technical blog posts for ZYL0 Blog.
Use when the user asks for a developer tutorial, Claude Code article,
MCP guide, architecture deep dive, or implementation note.
Produce Nuxt Content Markdown under content/blogs/ with frontmatter,
Japanese and English lang blocks, references, and disclaimers.
ポイントは「このSkillが得意なこと」ではなく「どの依頼文で必ず呼ぶか」を書くことです。Skill選択は読心術ではなくルーティングなので、入力側の言葉を明示した方が安定します。
2. 抽象語より、ユーザーが実際に言う語を入れる
私は最初、technical content や investment content のような抽象語を多く書いていました。しかし実際の依頼はもっと具体的です。「MCPの記事にして」「Claude CodeのSkillを直して」「AdSenseに通るブログ品質にして」のように、固有名詞と目的が混ざります。
descriptionには、きれいな分類語よりもユーザーが打ちそうな語を入れます。
| 弱い語 | 強い語 |
|---|---|
| technical content | Claude Code, MCP, API integration |
| creator content | YouTube, SNS, pricing, proposal template |
| investment content | semiconductor, CPO, AI infrastructure |
| quality content | AdSense, references, disclaimer, originality |
これはSEOと似ています。抽象度の高い言葉は人間にはきれいですが、ルーティング条件としては弱い。Skillは検索エンジンに近い気持ちで設計した方が実用的です。
3. Skillは読者別に分ける
ZYL0 Blogでは3つのSkillを分けています。
| Skill | 主な読者 | 必須要素 |
|---|---|---|
| zyl0-blog-writer | 投資家、CVC、個人投資家 | シナリオ、数値、一次情報、免責 |
| zyl0-creator-blog-writer | クリエイター、個人事業者 | 体験、Before/After、価格、CTA |
| zyl0-tech-blog-writer | エンジニア、開発者 | バージョン注記、コード、落とし穴、公式Docs |
1つのSkillに全部を入れると、毎回トーンがぶれます。投資記事にはシナリオ分析が必要ですが、クリエイター記事では長い銘柄表は読みにくい。技術記事にはコードと検証が必要ですが、一般向け記事では重くなりすぎる。
Skillは機能別ではなく、読者が何を価値と感じるかで分ける方が安定します。これは投資検討のチェックリストを領域別に分ける感覚に近いです。半導体、エネルギー、SaaSで見るべきリスクは違う。記事Skillも同じです。
4. frontmatterと保存先は固定する
Nuxt Contentの記事生成では、frontmatterを「適切に」とだけ書くと揺れます。揺れるとカード表示、OG画像、カテゴリページ、RSSで地味に壊れます。
ZYL0 Blogでは、この順番を固定します。
---
title: '日本語タイトル | English Title'
description: '日本語の概要。80〜160字。'
date: '22nd May 2026'
image: '/blogs-img/blog-slug.png'
alt: '画像説明。日本語。'
ogImage: '/blogs-img/blog-slug.png'
tags: ['テック解説', 'AI活用']
tagsEn: ['Tech Deep Dive', 'AI Tools']
published: true
---
私の運用では、正しい例を1つだけSkillに置くようにしています。複数パターンを置くと、モデルが「選べる」と解釈してしまうことがあるからです。
5. AdSense向けの品質ゲートをSkillに入れる
今回の大きな学びは、記事生成SkillにAdSense品質ゲートを入れないと、見た目は長くても「有用性の低いコンテンツ」に見える危険があることです。
最低限のゲートは次です。
| 品質ゲート | チェック内容 |
|---|---|
| 独自性 | 筆者の経験、仮説、判断軸が入っているか |
| 根拠 | 公式Docs、企業IR、公的資料、研究機関などを参照しているか |
| 再訪理由 | 次に何を追えばよいかが明確か |
| 免責 | 投資助言ではないこと、AI利用、利害関係可能性を明記しているか |
| 重複回避 | 同じ言い回しやテンプレ説明を繰り返していないか |
特に重要なのは、出典を「内部で参照するだけ」にしないことです。読者が確認できる参考資料を記事末尾に置く方が、信頼性とユーザー体験の両方で強いと判断しました。
6. 調査手順は固定しすぎず、一次情報を優先する
Skillには調査手順を書きます。ただし、情報源を固定しすぎると新しい一次情報を取り逃がします。
技術記事なら、最低限こう書きます。
Before writing:
- verify official documentation or release notes
- check GitHub changelog/issues where relevant
- avoid uncertain API behavior
- include references readers can revisit
投資記事なら、企業IR、規制資料、市場データを優先します。クリエイター記事なら、価格、工数、Before/After、実体験を優先します。調査の目的はリンクを増やすことではありません。不確かな主張を減らすことです。
7. Skill、Subagent、Hook、MCPを混ぜない
Claude Code周辺の機能は便利ですが、全部をSkillに押し込むと壊れやすくなります。
| 仕組み | 得意なこと | 入れすぎると起きる問題 |
|---|---|---|
| Skill | 文体、手順、出力形式、品質ゲート | 長すぎて運用ルールが読みにくくなる |
| Subagent | 独立調査、レビュー、並列作業 | 常時必要な文体ルールが抜ける |
| Hook | 実行前後の強制チェック | 判断が必要な編集方針まで止めてしまう |
| MCP | 外部データやサービス接続 | ローカル記事フォーマットが散らばる |
私の現在の整理はシンプルです。Skillは「どう書くか」、Subagentは「何を調べるか」、Hookは「事故を止める」、MCPは「外部情報へつなぐ」。この線引きがあるだけで、問題が起きたときにどこを直すべきかが分かりやすくなります。
8. 悪い例を1つだけ入れる
意外と効くのが、悪い例です。
# Bad
description: Write useful articles.
# Good
description: >
Use when the user asks to create, revise, or audit a bilingual ZYL0 Blog
article for AdSense review, especially when the request mentions references,
originality, disclaimer, AI tools, investing, or Claude Code.
良い例だけだと境界がぼやけます。悪い例が1つあると、どの抽象度がダメなのかが伝わる。これはチームの投資検討の標準化でも同じでした。「良いメモ」だけでなく「投資委員会で刺されるメモ」を見せた方が、品質基準は早く揃います。
9. 最後に監査コマンドまで書く
Skillは記事を作るだけでなく、最後に何を見るかまで持っていた方が強いです。
After writing:
- confirm frontmatter fields
- confirm Japanese and English blocks both exist
- confirm references and disclaimers exist in both languages
- run npm run build before publishing
今回のようにAdSense再審査を意識する場合は、本文量、参考資料、Next Issue Ideas、承認済みタグ、禁止MDC/HTMLも見るべきです。人間の目だけに頼ると抜けるので、軽量監査を最後に入れる価値があります。
10. Skillは魔法ではなく、判断を減らす仕組み
Skill設計で一番大事なのは、毎回の判断を減らすことです。文章の才能を保存する場所ではなく、運用ルールを保存する場所だと考えると設計しやすい。
ZYL0 Blogで使うSkillは、今後この方針に寄せます。
| 項目 | 新しい標準 |
|---|---|
| 出典 | 参考資料セクションを日英両方に入れる |
| 独自性 | 筆者の経験、仮説、判断軸を最低1つ入れる |
| 免責 | 投資助言ではないこと、AI利用、利害関係可能性を明記 |
| タグ | 承認済み8カテゴリのみ |
| 検証 | buildと軽量監査を実行 |
最初から完璧なSkillは作れません。発火しなかった依頼文、品質が足りなかった記事、審査で落ちた理由を、次のSKILL.mdへ戻していく。地味ですが、これが一番壊れにくい改善ループです。
次号の記事案
- 案1:AdSense再審査用ブログ監査チェックリスト — frontmatter、参考資料、免責、本文量、カテゴリを機械的に確認する運用を整理する。
- 案2:Subagentで記事リサーチを分業する型 — 投資、技術、読者ニーズを並列調査し、1本の記事に統合する実務フローを示す。
- 案3:MCPで社内ナレッジを記事制作に接続する — 調査メモ、過去提案、議事録をClaude Codeへつなぐ最短ルートを解説する。
関連記事
- Claudeで動画とウェブを"全自動"にしたら制作時間が1/5になった話 — Skills・MCP・Claude Designを組み合わせて、企画→デザイン→動画台本→公開までを一本の流れで回したら、制作時間が…
- Claude Skills・MCP・ウェブ制作・動画生成を実務で使い倒す:エンジニア向け実践ガイド2026 — Claude Codeのスキルシステム・MCPサーバー構築・ウェブサイト生成・Remotion動画制作まで、エンジニアが実際に業務で…
- Claude Code 2026年最新アップデート総まとめ|1Mコンテキスト・Skill・Hook・Subagent・MCP・Plan modeを実戦投入する — 2026年5月時点のClaude Code主要機能を、1Mコンテキスト、Skill、Hook、Subagent、MCP、Plan m…
参考資料
本文の技術前提と運用判断は、読者が後から確認できる一次情報・公式資料を優先して見直しています。
- Anthropic Claude Code documentation
- Anthropic Skills documentation
- Model Context Protocol documentation
本記事は情報提供を目的としたものであり、特定の銘柄、サービス、契約条件の推奨や投資助言ではありません。執筆者は記事内で触れた銘柄やサービスにポジションまたは利害関係を持つ可能性があります。調査、翻訳、校正の一部に生成AIを利用していますが、最終的な内容はZYL0が確認しています。詳細は免責事項をご確認ください。
















































































