Claude Codeが使えないのは、あなたが仕込んでいないから

「便利」で止まる人、「使えない」と言い出す人

「Claude Code使ってみた！便利！」という記事は山ほどある。

その大半の著者は、3ヶ月後に「やっぱり使えない」と言っている。

理由は単純だ。素のClaude Codeに、素のプロンプトを投げて、素の結果を受け取っている。包丁を研がずに「切れない」と言っているのと同じ。

Claude Codeの性能は、使う側の仕込みで決まる。ツールの問題ではない。仕込みの問題だ。

先日、AnthropicのエンジニアThariq氏がSkillsの設計ベストプラクティスを公開した。社内で実際に運用しているSkillsの知見を、9カテゴリに分類して体系化したものだ。

ここで最も見落とされている事実がある。Skillsは「ただのマークダウンファイル」ではない。フォルダだ。

スクリプト、アセット、テンプレート、設定ファイル。これらを内包した、ひとつの「能力パッケージ」。Claudeはフォルダの中身を探索し、必要なタイミングで必要なファイルだけを読みに行く。Progressive Disclosureと呼ばれる設計思想だ。

つまり、Skillsフォルダに入れたヘルパー関数やクエリテンプレートを使って、Claude自身がスクリプトをその場で組み立てる。人間がやるのは「火曜日に何が起きた？」と聞くことだけ。

Thariq氏の記事で、最も実践的だったのはこの一文だ。

The highest-signal content in any skill is the Gotchas section.

Gotchas。Claudeがそのスキルを使うときに、繰り返し踏む失敗パターンの一覧。

たとえばデザインスキルなら「Interフォントを選ぶな」「紫グラデーションを使うな」「Tailwindデフォルトの青を疑え」。ブログ執筆スキルなら「日本語でemダッシュを使うな、AIっぽく見える」「冒頭で自己紹介するな」「形容詞を動詞に置き換えろ」。

これは最初から完璧に書く必要はない。むしろ書けない。

失敗するたびに1行追加する。それだけでいい。

3ヶ月後には、そのSkillが「過去の自分が踏んだ地雷マップ」になっている。同じミスを二度踏まなくなるだけで、1セッションあたり数往復は確実に減る。

もうひとつ、地味だが効く仕込みがある。

Claude Codeはセッション開始時に、利用可能なSkillのdescription一覧をスキャンする。「このリクエストに使えるSkillはあるか？」を判断するためだ。

つまりdescriptionは要約ではない。トリガー条件だ。

悪い例:「PPTXを生成するスキル」。良い例:「ユーザーがスライド、プレゼン、資料、デッキに言及した時、またはPPTXファイルの作成・編集を求めた時に使う」。

前者ではClaudeが発火タイミングを判断できない。後者なら、「資料作って」と言った瞬間にSkillが起動する。

この差は小さく見える。だが毎日10回Skillを呼ぶ環境では、発火率の差がそのまま作業品質の差になる。

ここまで読んで気づいた人もいると思う。

仕込みに必要なのは、高度なプログラミングスキルではない。 Gotchasに1行追加する。descriptionを書き換える。スクリプトをフォルダに入れる。hookifyで破壊的操作をブロックする。どれも数分で終わる作業だ。

問題は、それを「やるかやらないか」だけ。

記事の中でThariq氏はこう締めている。

Most of ours began as a few lines and a single gotcha, and got better because people kept adding to them as Claude hit new edge cases.

最初は数行とひとつのGotchaから始まった。Claudeが新しいエッジケースに当たるたびに追記して、育てた。

道具は使うものではない。研ぐものだ。そして研いだ分だけ、切れ味が変わる。

ただ、ここまで書いておいて、ひとつだけ付け加えたいことがある。

道具をどれだけ研いでも、最終的にそれで何を作るかを決めるのは人間の仕事だ。

Skillsを9カテゴリで完璧に揃えても、Gotchasを100行蓄積しても、On Demand Hooksで安全装置を張り巡らせても。それは「切れ味のある包丁」を手に入れたに過ぎない。

その包丁で何を切るか。誰のために作るか。なぜ作るのか。

AIの時代に最も価値があるのは、道具の性能ではない。道具を研ぎ澄ませた上で、最高の仕事をする人間の判断だ。

仕込みは必要条件であって、十分条件ではない。切れ味のある最高の道具で、最高の仕事をする。それが引き続き、人間にしかできない、最も価値のあることだと思っている。