つまずき辞典

症状と対処

作ったのに、ふだんの頼み方で呼ばれない

第8章の​点検順​そのままです。
①説明文に​自分の​言い​回しが​入っているか​ ②ファイル名がSKILL.mdか・置き場所は​正しいか​ ③先頭の設定部分が​壊れていないか​ ④作りすぎで​説明文が​削られていないか。第8章の​点検を​任せる​依頼文で、​点検ごと​任せられます。

スキルの一覧に、そもそも出てこない

いちばん​多い​原因は、​その​会話の​開始後にskillsフォルダ自体を​新しく​作った​ことです。Claude Codeを立ち上げ直してください。
それでも​出なければ、​置き場所が​第5章の​2か​所から​外れています。
「このスキルが​どこに​あるか探して、​正しい​場所へ​移して」と​頼んでください。

「/名前」と打てば動くのに、ふだんの言葉では動かない

先頭の​設定部​分​（---で​挟まれた​数行）の​書式が​壊れている​サインです。
壊れていると​本文だけが​読み込まれ、​説明文が​空扱いに​なるので、​直接​呼べば​動くのに​自動では​選ばれません。
「この​スキルの​設定部分の​書式を​点検して、​壊れていたら​直して」で​解決します。

スキルを増やしたら、前より呼ばれなくなった

一覧表の​枠​（全体の​1%）から​あふれて、​呼ぶ回数が​少ない​スキルの​説明文が​削られています。第13章の棚卸しで、​今月​呼んでいない​スキルを退避してください。
枠が​空けば説明文は​戻ります。

症状と対処

関係ない依頼のときにまで発動する

説明文が​広すぎます。
「〜には​使わない」を​1行足すのが​第一手​（第7章）。
それでも​止まらなければ​「この​スキルを手動専用に​して」と​頼んで、​自分が​/名前で​呼ぶときだけ動く​設定​（disable-model-invocation）に​切り替えます。

手順書どおりに仕上がらないことがある

手順に​矛盾が​あるか、​例外の​扱いが​書かれていない​ケースが​大半です。
うまく​いかなかった​実例を​貼って​「この​場合の​扱いを​スキルに​追記して」と​頼んでください。
まとめて​直すより、​1行ずつ足す​ほうが​早く​安定します​（第14章）。

長い会話の途中から、スキルの指示が効かなくなった気がする

会話が​長くなると、​Claudeは​古いやり取りを​要約して​容量を​空ける​ことが​あり、​その際に​スキル本文の​一部が​畳まれる​ことがあります。
効きが​怪しくなったら、/名前で​もう​一度​呼び直してください。
全文が​読み直されます。

直したはずなのに、直る前の動きをする

同じ​名前の​スキルが​別の​場所にも​あって、​そちらが​勝っている​可能性が​あります。
同名は管理用→個人用→プロジェクト用の​順で​強いのでしたよね。
「この​名前の​スキルが​何か所に​あるか探して」と​頼むと、​すぐ​特定できます。

症状と対処

ブラウザ版Claudeへのアップロードで弾かれる

先頭の​設定部分に、標準の6項目（name・description・license・compatibility・metadata・allowed-tools）​以外が​混ざっています。
「このスキルをブラウザ版Claudeに​持ち込める​形に​直してzipに​して」と​頼めば、​項目の​整理ごと​やってくれます。

スキルにパスワードやAPIキーを書いていいか迷う

書かないでください。
スキルは​ただの​テキストで、​コピーも​共有も​簡単に​できてしまいます。
秘密の​値は​専用の​置き場（環境変数や​鍵管理）に​置いて、​スキルには​「どこを​参照するか」だけを​書きます。
この​設計も​Claudeに​相談できます。

配布されているスキルを入れたいが、少し不安

その​不安は​正しいです。
スキルは​指示と​プログラムで​Claudeに​新しい​動きを​させる​ものなので、​悪意ある​作りなら​危険も​あります。
公式も​「信頼できる​出どころの​ものだけを​使い、​導入前に​中身を​確認する」よう​求めています。
入れる​前に​「この​スキルの​中身を​全部​読んで、​何を​する​ものか、​怪しい​動きが​ないかを​報告して」と​Claudeに​監査させてください。
特にscriptsの中身は必ず。

パソコンの買い替えでスキルを失いそう

スキルは​フォルダなので、​コピーが​そのまま​引っ越しです。第13章の控えを​取る​依頼文で​控えを​作り、​新しい​パソコンの​同じ​場所​（~/.claude/skills/）に​置けば、​そのまま​動きます。