Claude Code Skill設計10パターン|確実に発火するdescriptionと運用テンプレ

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

22nd May 2026
Claude Code Skill設計パターンと発火条件を示す開発ワークフロー

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ユーザーが実際に入力する語を入れる
scopeSkill、Subagent、Hook、MCPの責務を混ぜない
quality gate記事生成では独自性、出典、免責を必須にする
validation生成後にビルドと軽量監査で確認する

Claude Code Skill設計10パターン|確実に発火するdescriptionと運用テンプレの要点を図解したフロー図

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 contentClaude Code, MCP, API integration
creator contentYouTube, SNS, pricing, proposal template
investment contentsemiconductor, CPO, AI infrastructure
quality contentAdSense, 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へつなぐ最短ルートを解説する。

関連記事

参考資料

本文の技術前提と運用判断は、読者が後から確認できる一次情報・公式資料を優先して見直しています。

本記事は情報提供を目的としたものであり、特定の銘柄、サービス、契約条件の推奨や投資助言ではありません。執筆者は記事内で触れた銘柄やサービスにポジションまたは利害関係を持つ可能性があります。調査、翻訳、校正の一部に生成AIを利用していますが、最終的な内容はZYL0が確認しています。詳細は免責事項をご確認ください。

Sponsored affiliate banner