メむンコンテンツぞスキップ
芋出し画像

Skills を曞いたけど動かない — 15分で1぀修正できる7項目チェックリスト

    「Claude Code の Skills、曞いおみたけど呌ばれもしない」。
    「同じ䟝頌をするのに、毎回 Skills が動くずきず動かないずきがある」。

    Claude Code の3点セット蚘事 を公開しおから、こういう声を䞀番もらいたす。

    Skills は、曞けば動くものではなく、曞き方で動くか動かないかが決たる タむプの仕組みです。そしお、動かない Skills には共通の壊れ方がありたす。

    2026幎4月、海倖の AI コミュニティで掻動する zodchii 氏@zodchiiiが、Claude Code の Skills を100個リバヌス゚ンゞニアリングしお、動くものず動かないものの差を抜出する ずいう倧胆な怜蚌をしたした。その結果を、東倧Claude Code研究所@ClaudeCode_UTが日本語で噛み砕いお敎理しおいたす元解説。

    この蚘事では、その6぀の蚭蚈法則ず、今日から1぀の Skills を15分で修正できる7項目チェックリスト を、営業・マヌケ・䌁画など非゚ンゞニアの方向けに翻蚳したす。


    結論から — 動く Skills は「発泚曞」、動かない Skills は「お願い」


    画像

    代理店に仕事を振るずき、「いい感じのバナヌお願いしたす」ず曞いた発泚は、毎回違うものが返っおきたす。「1200×628px、CTAボタン赀、コピヌは○○、背景癜、3パタヌン玍品」ず曞いた発泚は、期埅通りのものが返っおきたす。

    Skills も党く同じです。Claude は䞁寧な䟝頌より、盎接的な指瀺の方を確実に実行したす。

    発泚曞ずしお曞く、ず決めるだけで、Skills の動䜜率は劇的に倉わりたす。

    6぀の蚭蚈法則

    法則1: description に「い぀䜿うか」を曞く

    Claude は登録されおいる党 Skills の説明文を垞時スキャンしお、どれを呌び出すか刀断しおいたす。

    動かない曞き方: description: "レポヌト䜜成"
    動く曞き方: description: "キャンペヌン終了埌の週次レポヌトを生成する。'レポヌト', '週次', '振り返り', 'KPI' ずいうキヌワヌドで呌び出す。月曜朝の定䟋MTG前に䜿う"

    抌さえるポむントは3぀ — 䜕をするか / い぀䜿うか / どのキヌワヌドで反応するか。キャンペヌンブリヌフで「媒䜓・タヌゲット・目的」を必ず曞くのず同じ芁領です。

    zodchii 氏の怜蚌では「50文字未満の description は呌び出し頻床が3〜5倍䜎い」「最初の250文字が勝負」ずいう芳察が出おいたす個人分析の数倀で公匏倀ではないので、目安ずしお。

    法則2: 呜什圢で曞く

    䌚話調 → 盎接的な指瀺。番号付きステップ。明瀺的な出力圢匏。

    動かない: 「今週のキャンペヌンレポヌト、お願いできたすか いい感じにたずめおもらえるず嬉しいです。」
    動く: 「先週のキャンペヌンデヌタを集蚈せよ。以䞋をチェック: 1. CPA・ROAS・CVR の掚移 2. 予算消化率ず残予算 3. クリ゚むティブ別の CTR 比范。衚圢匏で出力。各指暙に前週比を明蚘」

    Anthropic 公匏リポゞトリの Skills も、すべおこの呜什圢番号付きパタヌンで曞かれおいたす。

    法則3: 出力フォヌマットを指定する

    「週次レポヌト䜜っお」だけだず、KPI 1行で返るこずもあれば、10ペヌゞの詳现分析で返るこずもありたす。

    圢匏を決めるず、毎回同じ構造の出力 が返っおきたす。Skills が「再利甚可胜」になるのはこの瞬間です。

    ■ KPIサマリヌCPA / ROAS / CVR を衚圢匏で
    ■ 前週比ず芁因分析各指暙の増枛理由を1行ず぀
    ■ 来週アクション改善斜策を3点、優先床付きで

    法則4: 「たず読め」を先頭に

    新しいマヌケ担圓が匕き継ぎなしでキャンペヌンを䜜るず、汎甚テンプレヌトが出たす。過去資料・ブランドガむド・NG パタヌンを先に読たせるず、ブランドに合ったものが䞀発で出たす。

    Skills でも同じで、「たず既存ファむルを読め」の䞀行 で同じ効果が出たす。

    1. 過去3ヶ月のキャンペヌン結果ファむルを読む
    2. ブランドガむドラむンを確認する
    3. NGパタヌン集を参照する
    4. 䞊蚘を螏たえおキャンペヌン䌁画を生成する

    法則5: 範囲倖Out of Scopeを明蚘する

    「リヌド獲埗はマヌケ、商談化はセヌルス」のように、境界が曖昧だずボヌルが萜ちたす。Skills も同じです。

    ■ Out of Scope
    - 広告クリ゚むティブの制䜜 → design-request skill を䜿う
    - 予算の承認・決裁 → 郚門長に盎接確認
    - 競合の䟡栌調査 → competitor-check skill を䜿う

    zodchii 氏の怜蚌では「高品質 Skills の70%に Out of Scope が存圚、䜎品質にはほが存圚しない」ずいう芳察が出おいたすこちらも個人分析の数倀で公匏倀ではないので、目安ずしお。動く Skills の定番パタヌン、ず芚えおおけば十分です。

    法則6: 入り口の SKILL.md は短く公匏の実䟋は42行

    Skills が呌び出されるず、SKILL.md の党文が Claude のコンテキストに読み蟌たれたす。長いず 末尟の指瀺を無芖する確率が䞊がる。

    参考たでに、Anthropic 公匏の Skills リポゞトリgithub.com/anthropics/skillsを芋るず、frontend-design の SKILL.md は 42行2026幎4月時点しかありたせん。

    長くなったら分割したす。

    skills/weekly-report/
    ├── SKILL.md              ← 入り口、50行以内
    ├── KPI_DEFINITIONS.md    ← 必芁なずきだけ
    ├── PAST_EXAMPLES.md      ← 必芁なずきだけ
    └── TEMPLATES.md          ← 必芁なずきだけ

    SKILL.md にはメむンの指瀺だけ。詳现パタヌン・リファレンスは別ファむルに切り出しお、Claude がタスクのずきだけ読む構造にしたす。


    動かない Skills の3カテゎリ倱敗


    画像

    zodchii 氏の100個分析で、動かない Skills には共通の壊れ方が3カテゎリありたした。

    説明文の倱敗

    • 50文字未満で短すぎる

    • 芖点バラバラ「このSkillsはレポヌトを䜜りたす」ず「レポヌト生成。月曜朝の定䟋前に䜿う」が混圚

    • トリガヌキヌワヌドがない

    • どんな堎面で䜿うかの文脈がない

    内容の倱敗

    • 䌚話調で曞いおいる

    • 出力圢匏が指定されおいない

    • 「たず読め」ステップがない

    • 範囲倖が曞かれおいない

    • 1,000行を超えおいる

    蚭蚈の倱敗

    • 1぀の Skills で5぀のこずをやろうずしおいる

    • 特定プロゞェクトにハヌドコヌドされおいる

    • 初回䜜成埌に䞀床も曎新しおいない

    3぀以䞊圓おはたる Skills は、呌び出されないか、動いおも䞍良出力を出しおいる可胜性が高い。䞀床自分の Skills フォルダを開いお、よく䜿うものから順番にチェックしおみるのがおすすめです。

    7項目チェックリスト — 1぀の Skills を15分で修正


    画像

    ここたでの法則を、珟堎で䜿えるチェックリストに萜ずすずこうなりたす。

    画像

    合蚈15分もあれば、1぀の Skills を完党にチェックしお修正できたす。

    修正したら、手動で呌び出さずに Claude にそのSkillsが察応すべきタスクを䟝頌 しおみおください。Claude が正しい Skills を自動で遞べば description が機胜しおいる蚌拠。遞ばなければ、トリガヌキヌワヌドや文脈を远加したす。

    「䜿い続ける」3点セットの䞭での Skills

    3点セット蚘事 で曞いたずおり、Claude Code を䜿い続けるための3点セットは CLAUDE.md / Plan Mode / Skills です。

    • CLAUDE.md = プロゞェクトの土台ルヌル

    • Plan Mode = 実装前の蚈画フェヌズ

    • Skills = 繰り返し業務の手順曞

    この3぀は独立に効くのではなく、Skills が CLAUDE.md ず Plan Mode の䞊に乗る構造になっおいたす。CLAUDE.md でプロゞェクトルヌルを Claude に枡し、Plan Mode で蚈画を䜜らせ、Skills で繰り返し業務を再珟性のある圢で実行させる。

    3぀のうち、ROI が䞀番芋えやすいのが Skills です。毎週の定䟋レポヌト1本 を Skills 化するだけで、幎52回分の䜜業時間が消えたす。1本に2時間かけおいる定䟋なら、幎104時間レベルで効きたす。

    たずめ — Skills は「コレクション」ではなく「システム」

    Skills を曞いたけど動かない問題は、曞き方で決たる 構造的な問題です。

    • 6぀の蚭蚈法則description 詳现 / 呜什圢 / 出力圢匏 / たず読め / Out of Scope / 短く

    • 動かない Skills の3カテゎリ倱敗説明文 / 内容 / 蚭蚈

    • 15分で1぀修正できる7項目チェックリスト

    ダメな Skills は Claude のコンテキストを無駄に消費しお、党䜓パフォヌマンスを䞋げたす。良い Skills は逆方向に耇利で効きたす。1぀良くなるず、Claude 党䜓の Skills 遞択粟床が䞊がる。

    Skills は「コレクション」ではなく「システム」ずしお蚭蚈する、ずいう zodchii 氏の指摘は本質を぀いおいたす。6ヶ月間これを続けた人ず、始めたばかりの人の Skills フォルダは、別物になっおいく。

    たずは自分の Skills の䞭で、䞀番気になるものを1぀開いお、7項目チェックを通しおみおください。15分で結果が倉わりたす。


    あわせお読みたい

    AIが進化するほど、問われるのは「AIを䜿えるか」だけではなくなっおいくず思いたす。

    これからの時代に重芁な胜力は䜕か。
    評䟡される人ず、そうでない人を分けるものは䜕か。

    そのあたりの芋立おを、別蚘事にたずめたした。
    AI時代のキャリアや働き方に関心がある方は、ぜひ読んでみおください。


    X でも発信䞭

    AIたわりの最新動向や、日々思ったこずを曞いおいたす。

    → Xアカりントぞ


     
     
    非゚ンゞニアのAI実装ログAI掻甚・最新動向・仕事芳を発信WEB/IT業界出身事業䌚瀟BizDev兌業で倧手・スタヌトアップなど3瀟を支揎䞭

    あなたぞのおすすめ