Claude Code ではフォルダを置き、名前は変えない
ディレクトリは ~/.claude/skills/ かプロジェクトの .claude/skills/ に置き、フォルダ名が SKILL.md の name と一致したままになるようにしてください。特定のコードベースの規約を書いたスキルならプロジェクト側、自分の作法を書いたスキルなら個人側を選びます。置き場所を誤ったスキルは壊れているわけではなく、誰も求めていないセッションに居座るだけです。
claude.ai と API ではアップロードする
claude.ai はスキルのフォルダを ZIP ファイルとしてスキル設定から受け取ります。スキルはコード実行環境で動くため、コード実行を有効にしておく必要があります。Claude API は /v1/skills エンドポイントでスキルを受け取り、各リクエストはコード実行ツールと並べて container パラメータに skill_id を指定します。API に入れたスキルはワークスペース全体で使えます。各環境のコピーは同期しないので、ある環境で直した内容はほかの環境にもアップロードし直す必要があります。
入れる前に読む
スキルはエージェントが従う指示であり、実行を許されたスクリプトを同梱していることもあります。読まずに入れるのは、テーマを適用するより、知らない相手のシェルスクリプトを走らせる行為に近い。エージェントに何をさせる内容か、scripts/ に何が入っているかを確認し、出所をたどれるスキルを選んでください。
コピーではなく読み込みを確認する
導入の不具合として報告されるものは、ほぼ常に、ディレクトリ名と一致しない name か、どのタスクにも当たらないほど曖昧な description です。そのスキルが担うはずの作業をそのまま依頼し、振る舞いが変わるかを見てください。何も変わらないなら、原因は置き場所ではなく description です。