ハブやコンパニオンを作業ツールとして扱わない。
ハブはパックを並べます。コンパニオンページは 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 を見てください。