
AI Skill手書きガイド:Claude Codeで再利用可能な能力モジュール
ZennClaude Codeの Skill は繰り返す指示を再利用可能なモジュール化する仕組みだが、「原則」ではなく「手順」を具体的に書くことが動作のカギとなる。SKILL.md ファイルの構造、description の書き方、禁止事項の明示方法を詳解し、手書きで30分程度で新規 Skill を作成できる実践的な方法を示す。
全 2065 件 · 72 / 104 ページ

Claude Codeの Skill は繰り返す指示を再利用可能なモジュール化する仕組みだが、「原則」ではなく「手順」を具体的に書くことが動作のカギとなる。SKILL.md ファイルの構造、description の書き方、禁止事項の明示方法を詳解し、手書きで30分程度で新規 Skill を作成できる実践的な方法を示す。

Google I/O 2026で Gemini 3.5 Flash と Antigravity 2.0 が発表され、エージェント中心の戦略が加速。OpenAI は8,520億ドル評価で資金調達完了しIPO視野に入り、Anthropic は Stainless を買収してSDK統合を主導。国内では政府AI「源内」が18万人規模で本実装開始し、PoCから本格展開への転換が業界全体で鮮明になった。

Codex と Claude Code を同じリポジトリで併用する際、作業引き継ぎの曖昧さから予期しない修正範囲拡大や権限超過が発生する問題に直面。これを防ぐため、handoff を単なる依頼文ではなく「目的契約」「範囲契約」「権限契約」「完成契約」「検証契約」「失敗契約」の6層に分けた多層契約チェックリストを実装した。


Claude Code や Cursor を日常的に使う開発者が、AI との認識ズレを減らし手戻りを最小化するために実践している工夫を整理。プランモード・grill スキル・複数 AI の併用・セッション管理(/compact, /clear)など、公式機能と運用の工夫で出力の安定性を高める具体的な方法を紹介。

非エンジニアがSaaS本番リリースに向けた9ヶ月の実装フェーズで、Claude Code・Codex・Cursor Composerの主役が段階的に交代。Claude Codeは文脈喪失で命名規則やディレクトリ構成を忘れる限界を露呈し、Codexの「多ファイル跨ぎの面を押す力」で置き換わったが、Cursor Composerのレビュー精度向上により最終的に「Codex実装 / Codex + Cursor レビュー」の分業体制に落ち着いた。

Anthropic が 2025 年 12 月に Claude Skills をオープン標準化した直後、OpenAI と Microsoft がほぼ同時期に同じ SKILL.md 形式を採用した。SKILL.md は単一 Markdown ファイルに YAML メタデータを置くだけの極小設計で、段階的開示(Progressive Disclosure)により起動時のトークン消費を MCP 比で 90% 削減。2026 年 5 月には skills.sh マーケットプレイスに 40 万件が登録され、npm が 7 年で到達した規模を 4 ヶ月で超えた。

著者が Claude Code 用の設定テンプレ cc-safe-setup を公開したところ、14日で延べ9,398回の npx 実行、736人の利用者に達した。GitHub ページ閲覧数より実行数が4倍以上多く、文書を読まずに即実行する利用者が大多数。公開後は利用者からのフィードバックが改善を主導し、当初「月10人程度」と見込んでいた期待値を大きく上回った。

Claude WebはブラウザですぐAIチャットが使えて初心者向け、Claude Desktopはローカルファイルや外部ツール連携に対応した作業パートナーとして機能する。MCPを活用すれば GitHub や Notion などの外部ツールを AI に接続でき、用途に応じて最適なツールを選ぶべき。


SES 派遣エンジニアが急速に進化する AI を見つめ直し、人間にしかできない「感じること」と「目指す方向を決めること」に価値を見出した。Claude Code を活用しながらプロダクト設計を学び、インディーハッカーとして自由な開発を目指す過程を発信していく。

Claude Codeはデバイスが変わるとセッション再開ができない制限があるが、Google Driveにセッションデータを同期し、ジャンクション/シンボリックリンクで参照することで、Windows と Mac 間で同じセッションを /resume で再開可能にする手法を解説。Google Drive Desktop の仕様を踏まえた逆向きリンク構成がポイント。

複数の Claude Code インスタンスがチームとして連携する Agent Teams 機能を活用し、チームリーダー・デザイナー・プログラマーの役割分担でスイカゲーム風パズルゲームを開発する手法を紹介。MCP 経由で PixelLab(画像生成)と Godot(ゲーム開発)を統合し、並列処理による効率的な開発フローを実現する。

Claude Code が 2026 年春に公開した Routines(クラウドスケジュールタスク)と Channels(Telegram・Discord・iMessage 連携)を整理。スケジュール実行は CLI /loop、Desktop Scheduled Tasks、Cloud Routines の 3 層構造を持ち、GitHub イベントトリガーにも対応。低リスクな Issue トリアージや PR 整理から試すことが推奨される。

Cloudflare の MCP server portals を使うと、リモート MCP サーバーを Claude Desktop の code mode として利用できる。OAuth による認可管理やアクセスポリシー設定が容易で、複雑なクエリでは標準 MCP 比でトークン消費を削減できる利点がある。

ソニックガーデンのエンジニアが Claude Code で毎日の日報レビューと週次 KPT 準備を自動化するエコシステムを構築。実際の親方のコミュニケーションスタイルを反映した oyakata エージェントが日々フィードバックを提供することで、ふりかえりが週 1 回のイベントから継続的なプロセスに変わり、準備不足でのミーティング参加が解消された。

Fin-JAWS LT の続編として、boto3 Converse API と Tool Use により Claude に vector_search ツールを持たせ、Aurora pgvector を直叩きしてエンドツーエンドに回答させる構成を検証。Knowledge Bases を使わず SQL レベルで可視化した RAG 実装の詳細と、1st turn ツール選択率 100% を達成した結果を報告。

Anthropic が公開した Routines は、Claude Code のタスクをクラウドインフラ上でスケジュール実行できる機能。スケジュール実行・API エンドポイント・GitHub イベントの 3 つのトリガーに対応し、ローカルマシンやサーバーが不要になる。Pro・Max プランなら 3 回まで無料で試用でき、バグ報告の自動処理や定期的なドキュメント監視などの定型タスク向けに適している。
