ポータブルスキルの使わない方法

description が曖昧だったり、ファイルが巨大だったり、ショップページを作業ツールとして扱ったりすると、スキルは静かに失敗します。セッションを無駄にするミスです — 正直に、叱らずに。

ハブやコンパニオンを作業ツールとして扱わない。

ハブはパックを並べます。コンパニオンページは Setup です。コピーまたはダウンロード。どちらもワイヤーフレームを描いたり、監査を走らせたり、ブレークポイントを撮ったりしません。その仕事には、対応するブラウザツールを開くか、インストール済みスキルをエージェントで動かしてください。

一度インストールしたうえで、同じスキルを別ワークフローとしてダウンロードしない。

npx skills@latest add iruhdam1/skills を実行するか、または コンパニオンから1パックをダウンロードしてください — 同じスキルに両方は使わないでください。コピーが2つあるとずれ、エージェントが古いほうを読むことがあります。

一人称や曖昧な description を書かない。

Claude や他のホストは description フィールドからスキルを見つけます。一人称(「I help you…」)や空の範囲だと、エージェントはファイルを選びません。何をするか、いつ使うかを三人称で書いてください。Anthropic のオーサリングメモも同じルールです。

SKILL.md に全部詰めない。

本文は手順のままにしてください。長いメモは1階層下の隣の参照ファイルに置き、ホストが必要なときだけ読めるようにします。テキストの壁はコンテキストを燃やし、トリガーを隠します。

ショップの .agents/skills をコピーしたり Analog を編集したりしない。

このショップの .agents/skills フォルダ(COSS、Phosphor、その他のエージェントヘルパー)は公開パックではありません。コピーしないでください。Analog を編集しないでください。公開セットはハブに載っている GitHub パックです。

skills.sh の掲載漏れを追いかけない。

skills.sh は公開一覧とインストールのテレメトリです。バッジがないことは、GitHub の push 失敗ではありません。パックがまだ載っていなければ GitHub かショップのコンパニオンを使ってください。skills.sh vs GitHub を見てください。