
Claude Code の「スキル(Agent Skills)」入門。同じ指示を毎回貼り付ける作業を SKILL.md 一枚で卒業する
QiitaClaude Code のスキル機能は、繰り返し伝える手順をひとまとまりの SKILL.md ファイルに集約し、必要なときだけ読み込ませる仕組み。CLAUDE.md との違い、実装方法、フロントマターの仕様、組み込みスキル、トラブルシューティングを公式ドキュメント(2026年9月17日時点)に基づき解説。
全 1772 件 (Qiita で絞り込み) · 12 / 89 ページ

Claude Code のスキル機能は、繰り返し伝える手順をひとまとまりの SKILL.md ファイルに集約し、必要なときだけ読み込ませる仕組み。CLAUDE.md との違い、実装方法、フロントマターの仕様、組み込みスキル、トラブルシューティングを公式ドキュメント(2026年9月17日時点)に基づき解説。


Claude Codeを使ってYouTube 24時間ライブ配信を自動管理するシステムを開発する過程で、テストが通っても実際には失敗していたケースが連続発生。正規表現の日本語非対応、シェルのパイプ戻り値の罠など、実装の落とし穴と対策として「本番と同じ形式の陽性対照を埋め込む設計パターン」を紹介。

Anthropic が提供する Claude は複数の製品形態(claude.ai、Claude Desktop、Claude Code、Cowork、Design など)を備えており、初心者は用語の区別に困りがち。本記事は claude.ai(サブスクリプション)と Claude API(従量課金)の違い、旧称「Anthropic API」との関係性を整理し、どのツールをどの場面で使い分けるかを明確にする入門ガイド。


Claude Cowork のスケジュールタスクと Claude Code の Routines を使い SaaS API からデータ取得してドキュメント自動生成する際の認証情報管理を比較。MCP コネクタ、API credentials、環境変数、外部リモート MCP サーバーの 4 パターンの選択肢があり、プランや連携先の対応状況によって推奨される管理方法が異なる。

Claude Codeをメイン開発ツールとして使う筆者が、CLAUDE.md分離管理・Plan Mode・サブエージェント・Hooks・スラッシュコマンド・MCP連携・コンテキスト管理の7つの実務Tipsを公開。settings.json の実物やターミナルコマンドを交えながら、コンテキストウィンドウの効率化・うっかり事故の防止・定型作業の自動化といった具体的な運用ノウハウを解説。

Claude Code で複数セッションを並行実行する際の課題(タブ移動、実行許可の見落とし、脳の切り替え負担)を解決するため、Go と vanilla JS で単一バイナリのセッション管理アプリ csviz を開発。セッション一覧・会話の横並び表示・リアルタイム反映・定型業務の定期実行などを1つの Web UI で完結させ、セッション JSONL の内部仕様も詳解。

Anthropic が Claude をチャットツールから総合的な作業プラットフォームへ転換した。文書作成、スライド生成、データ処理を統合し、ユーザーが複数アプリを往復する手間を削減。Google Home との連携でも AI Agent が家電制御層にアクセス可能になり、実務効率化の競争が機能追加から「迷わせない設計」へシフトした。

Claude Code 使用時にメッセージ一覧の不整合によるクラッシュが発生する場合の切り分け方法を解説。GitHub Issues で複数報告されている症状について、実際の環境で検証した確認手順と発生条件の整理方法を提示。

Claude Code 2.1.273 で拒否ルールの検証を 120 回実施したところ、eval や env -C コマンドは拒否ルールではなく、その手前の Bash 静的解析で制御されていた。拒否ルールを全削除しても制御は変わらず、--dangerously-skip-permissions フラグで静的解析を迂回するとすべてのコマンドが実行できた。

Claude Code 運用時に CLAUDE.md は 200 行以下を目安に、コードベースから導出可能な情報は削除し、プロジェクト固有の落とし穴・設計理由・独自規約のみ記載すべき。抽象的なルールではなく「インデントはスペース 2 つ」など検証可能な具体例を書き、CLAUDE.md は安全装置ではなく「何をすべきか」を伝えるツールと位置づけることが重要。



Notion 3.7 でAgent Skillsが導入され、チーム内で作成・管理したプロンプトのノウハウを SKILL.md 形式で Claude Code、Cursor、Codex、Gemini、Grok へエクスポート可能になった。Notionが複数のAIエージェント間での指示セットの正本として機能し、各開発者がローカル環境で同じスキルセットを利用できるほか、Custom Agent のサブエージェント化、Custom MCP 接続(ベータ)、Agent SDK パブリックベータも同時リリースされた。

artifact-design Skill は Claude Code に組み込まれたデザイン指針で、HTML や Markdown の成果物を単なる表示から「見る人の目的に合わせた見た目」へ整える役割を担う。題材・読者・目的から配色やレイアウトを判断し、テンプレートに頼らず既存デザインを優先しながら、資料は資料らしく、UI は UI らしく作る設計になっている。




複数のエージェント設定を分散管理する運用で、決定事項が指示ファイルに反映されない、あるいは指示があるのに同じ誤りが繰り返される問題に直面。決定メモと指示ファイルを Bash スクリプトで機械的に突き合わせ、未反映項目を自動検出する方法と、繰り返し発生する誤りを書き手ではなくレビュー担当の判定基準に組み込む運用改善を紹介。