AIスキル設計の6つの罠 — Matt Pocock Skills v1.0.0が体系化した「予測可能なAIマニュアル」の書き方
Hiroba による自動要約
Total TypeScript著者のMatt Pocock氏がClaude Code用スキルセットv1.0.0をリリース。個々のスキル実装より重要な「スキル設計論」として、6つの失敗パターン（Model/User-invoked分類、Leading Word、No-op Test、Premature Completion等）をすべて「予測可能性」という単一原則に集約。実装時の判断基準とコスト・トレードオフの仕組みを体系化した。
読んで良かったら、シェアしてみてください。
同じタグの記事が他に 1737 件あります。
関連する記事
同じタグの記事
SKILL.md は 220 行で切られる前提で書く
ZennCodex CLI が SKILL.md の末尾を途中で切断する実例が報告され、Claude Code でも同様の挙動が発生する。AetherEchoes で auto-publish スキルの停止原因が末尾の指示読み取り失敗だったため、200 行以内・鉄則は冒頭配置・共通ロジック切り出しの指針を採用した。LLM 向け指示ファイル設計の実践的な知見を共有。
Claude Code で別セッション同士を会話させる Skill を実装 ─ 無限ループ防止と同時書き込み衝突の解決記
Qiita2つの独立した Claude Code セッションが共有ファイルシステムを利用して非同期通信する Skill を実装。1メッセージ=1ファイル方式で衝突を回避し、message type の制限と往復回数の上限で「ありがとう→いえいえ」無限ループを構造的に禁止。実装時に遭遇した採番衝突やファイル競合などの課題と解決方法を記録。
Claude Code のスキルが自動で発火しない本当の理由——未文書設定 skillListingMaxDescChars(既定1536字)を実機で確かめた
QiitaClaude Code でスキルが自動で起動しない原因は、公式ドキュメントに未記載の 2 つの設定値 skillListingMaxDescChars(既定1536字)と skillListingBudgetFraction(既定0.01)による description の黙った切り詰めにあった。バイナリ実装を確認した上で、settings.json での対処方法と description 設計のポイントを解説。
/dmg – Claude Code スキル（永続的なメモリとセッション同期）
HNClaude Code の slash コマンド /dmg は、セッション終了時にリポジトリをコミット、ドキュメントを更新、永続的なメモリシステムを同期することで、次のセッション開始時にプロジェクトの完全なコンテキストを引き継ぐ。セッション間のコンテキストリセット問題を解決し、毎回の説明が不要になる。