https://hdknr.github.io/blogs/tags/skill.md/Recent content in SKILL.md on hdknr blogHugo -- 0.157.0jaThu, 21 May 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/05/anthropic-agents-to-skills-redesign/Thu, 21 May 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/05/anthropic-agents-to-skills-redesign/<p>Anthropic の研究・プロダクトチーム（Barry Zhang・Mahesh Murag）が、2025年11月の AI Engineering Code Summit で衝撃的な発言をした。</p> <blockquote> <p><strong>「Agents をやめて、Skills に全振りした」</strong></p> </blockquote> <p>Agent ツールを実際に開発してきた当事者が、この言葉を口にした意味は重い。単なる命名変更ではなく、AI 自動化の設計哲学そのものが変わった瞬間だ。</p> <p>この記事では、なぜ Anthropic が Agents から Skills へシフトしたのか、その背景と技術的な理由、そして今すぐ自分のワークフローに活かせるポイントを解説する。</p> <h2 id="agents-の限界--何が問題だったのか">Agents の限界 — 何が問題だったのか</h2> <p>従来の「Agent」アプローチの核心は、<strong>中央集権型オーケストレーター</strong>だった。1 つの LLM が多数のツールを持ち、あらゆるタスクに対応しようとする構成だ。具体的には以下の 4 点が問題になった。</p> <ul> <li><strong>ツールオーバーロード</strong>: ツール数が増えるほど、LLM はどのツールを使うべきか判断しにくくなる</li> <li><strong>再現性の低さ</strong>: 複雑なシナリオで中央オーケストレーターが混乱し、同じ入力に対して異なる結果が出やすい</li> <li><strong>モデル依存</strong>: Claude 専用に設計された Agent は、他のモデルでは動かない</li> <li><strong>コンテキスト肥大化</strong>: すべての能力を一度にロードするため、トークンが無駄に消費される</li> </ul> <p>Barry Zhang と Mahesh Murag はこれらの問題を実装レベルで体験し、「根本から再設計が必要だ」という結論に至った。</p> <h2 id="skills-とは何か--agent-との本質的な違い">Skills とは何か — Agent との本質的な違い</h2> <p>Skills は、Claude Code の拡張機能の単位だ。<code>SKILL.md</code> と必要なスクリプト・設定ファイルを 1 つのフォルダにまとめて定義し、必要なときだけオンデマンドでメイン会話コンテキストに注入される。</p> <table> <thead> <tr> <th>観点</th> <th>Agents</th> <th>Skills</th> </tr> </thead> <tbody> <tr> <td>設計思想</td> <td>中央集権型オーケストレーター</td> <td>モジュラー・再利用可能な能力単位</td> </tr> <tr> <td>モデル対応</td> <td>Claude 専用</td> <td>Claude + 他モデル両対応</td> </tr> <tr> <td>実行コンテキスト</td> <td>独立した隔離環境</td> <td>メイン会話内（記憶・フォローアップが可能）</td> </tr> <tr> <td>ロード方式</td> <td>常時ロード</td> <td>オンデマンド（トークン節約）</td> </tr> <tr> <td>再現性</td> <td>複雑なシナリオで低下しやすい</td> <td>実用レベルで高い</td> </tr> </tbody> </table> <p>最も重要な変化は<strong>モデル非依存</strong>になったことだ。Anthropic は 2025年12月に Skills をオープンスタンダードとして <a href="https://agentskills.io">agentskills.io</a> で公開し、Microsoft/VS Code・OpenAI・Cursor・GitHub・Google Gemini CLI・JetBrains Junie など主要プラットフォームが採用済みだ。Claude だけでなく、他のモデルでも同じスキルが動作する。</p>https://hdknr.github.io/blogs/posts/2026/05/claude-skill-post-merge-trap/Wed, 13 May 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/05/claude-skill-post-merge-trap/<h2 id="症状">症状</h2> <p><code>blog-batch.sh</code> で夜間バッチを回した結果、こんな状態になっていた:</p> <ul> <li>同じ wiki ファイル（<code>content/wiki/concepts/harness-engineering.md</code>、<code>content/wiki/tools/claude-code.md</code>）が<strong>複数の blog PR で同時に変更</strong>されていた</li> <li>main にマージしようとすると毎回コンフリクト</li> <li>直近の #368・#369・#371・#372 はすべてこの原因で手動コンフリクト解消が必要だった</li> </ul> <p>調査して原因が判明したので、修正内容と「LLM スキルを書くときに気をつけるべきポイント」を共有する。</p> <h2 id="pr-の中身を見ると-3-コミットあった">PR の中身を見ると 3 コミットあった</h2> <p>通常の <code>/blog</code> で作った PR は「記事 1 本分の 1 コミット」のはずだが、見ると 3 コミットあった:</p> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>35a61c2 Add blog post: トレーダーのSランクスキル5選... </span></span><span style="display:flex;"><span>86e5bd4 Update wiki-last-ingest.txt: mark all posts through 2026-05-07 as ingested </span></span><span style="display:flex;"><span>0bc4e1f Update Wiki: ingest posts 2026-04-15 through 2026-04-21 (5 updated, 16 new pages) </span></span></code></pre></td></tr></table> </div> </div><p>2 つ目と 3 つ目は <strong>wiki ingest の結果コミット</strong>。これが各 blog PR に混入していて、複数 PR で同じ wiki ファイルを並行更新 → コンフリクトという流れ。</p>