結論から
- 1初回は名前で呼び出します。Claude Code と Cursor では
/skill-name、Codex では$skill-name。 - 2事実、ファイル、サイズは同じメッセージにまとめて書きます。
- 3作られたファイルを開き、具体的な修正を 1 つずつ依頼します。
最初のメッセージですべてを伝える
結果の大部分は最初のメッセージで決まります。抜けている部分は、Skill が推測やプレースホルダーで埋めてしまいます。プロダクト、対象読者、重要な事実、ファイルを一度に伝えましょう。
具体的で抜けがない
- 「
/launch-pageParcelo は小規模なオンラインショップ向けの荷物追跡サービス。対象：ショップのオーナー。3 つの機能：リアルタイム地図、SMS 通知、返品対応。ロゴ：assets/logo.svg。」
あいまい
- 「ランディングページを作って。」
- Skill はあなたに質問するか、空いた部分をプレースホルダーのテキストで埋めるしかありません。
Claude Skills の活用例：成果物ごとに用意するもの
成果物の種類によって、必要な入力は異なります。始める前にこの表を確認しましょう。メッセージに足りないものは、エージェントが作り上げてしまいます。
| 成果物 | 用意するもの |
|---|---|
| 画像 | 被写体、スタイルや参考画像、サイズやアスペクト比、画像に入れるテキスト（正確な表記で） |
| 動画 | 長さ、アスペクト比、台本や要点、映像素材、ロゴ、音楽 |
| Web ページ | 実際のコピーとプロダクトの情報、ブランドカラーとロゴ、必要なセクション |
| スライド | 元になるメモや資料、対象となる聞き手、おおよそのスライド枚数 |
実際に作られたものを確認する
エージェントの要約で判断しないでください。ファイルを開きましょう。
「完了しました」というメッセージが問題なさそうに見えても、見出しがはみ出していたり、リンクがどこにもつながっていなかったりします。次の簡単なチェックで、ほとんどの問題を見つけられます：
画像
サイズと比率を確認し、画像内の文字を 1 文字ずつ読みます。
動画
最後まで見て、画面上のテキストが読めることを確認します。
Web ページ
ブラウザで開き、スマートフォンの幅まで狭めて、すべてのリンクをクリックします。
スライド
枚数を数え、はみ出したテキストを探し、数字を元の資料と照らし合わせます。
より良い 2 稿目を引き出す
修正は同じチャットで依頼しましょう。そこではエージェントが Skill の手順と、あなたの以前の回答をまだ覚えています。そのうえで、何を変えて何を残すのかを正確に伝えます。
- ファイルと場所を指定する：「
hero.pngの見出しを大きくして」 - 残すべきものを伝える：「レイアウトはそのままで、色だけ変えて」
- 修正は 1 つずつ依頼し、それぞれの効果がわかるようにする。
- 初稿が大きく外れているなら、より良い入力で新しく実行し直す。悪い初稿を手直しするほうが時間がかかります。
うまくいかないとき
エージェントが Skill を無視する
名前で呼び出します。それでも読み込まれない場合は、トラブルシューティングをご覧ください。
途中で止まる
必要なものが足りていません。Skill ページの「依存関係」に載っているものをインストールしてください。
API key を求められる
その Skill は「外部コスト」に記載された有料サービスを使います。key はそのサービスのドキュメントどおりに設定し、チャットには絶対に入力しないでください。
結果が依頼内容とずれている
足りない情報やファイルを渡し、その部分だけやり直すよう頼みます。
よくある質問
Claude Skills はどうやって使いますか？
Claude Code で / と Skill の名前を入力し、同じメッセージでやりたいことを伝えます。初回の実行後は、Skill の description に合う普通の依頼をすれば自動で読み込まれます。
毎回 Skill を名前で呼び出す必要がありますか？
いいえ。初回は名前で呼び出して動作を確認しましょう。その後は、たいていタスクを説明するだけで十分です。エージェントが別の Skill を選んだら、もう一度名前で呼び出してください。
Claude Skills の活用例には何がありますか？
繰り返し行い、見た目をそろえたい作業向けの Skill が好例です。ランディングページ、スライド、カバー画像、解説動画などがあります。成果物別に Skill を見ると、さらに多くの例が見つかります。
Skill がプレースホルダーのテキストを出してきたのはなぜですか？
メッセージに必要な情報が足りなかったからです。実際のプロダクト情報、コピー、ファイルを追加し、その部分をやり直すよう頼んでください。
出典
このガイドは役に立ちましたか？