# Edit Skill > Claude Codeスキルの作成・更新を公式仕様に基づいて行う。新しいスキル作成（create）や既存スキルの更新（update）時に使用。 Use when this capability is needed. - Skill: `tomevault-io/edit-skill` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/edit-skill` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/edit-skill/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/edit-skill --- ## Step 1: サブコマンド判定 - `$ARGUMENTS[0]` が `create` → Step 3（新規作成フロー）へ - `$ARGUMENTS[0]` が `update` → Step 4（更新フロー）へ - 未指定 or 上記以外 → AskUserQuestion で create / update を選択させてから対応する Step へ スキル名は `$ARGUMENTS[1]` から取得する。未指定の場合は各フロー内で確認する。 ## Step 2: ドキュメント確認と差分チェック WebFetchで を取得し、「フロントマターリファレンス」テーブルの全フィールド名を抽出する。以下の既知フィールド一覧と比較し、差分があれば警告してこのスキル（edit-skill）のアップデートが必要な旨を伝える。差分がなければ次の Step に進む。 **既知フィールド:** `name`, `description`, `argument-hint`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `model`, `context`, `agent`, `hooks` ## Step 3: 新規作成フロー ### Step 3-1: スキル設計インタビュー ユーザーに以下を確認する（AskUserQuestionを使用）: #### 基本設定 1. **スキル名**: - `$ARGUMENTS[1]` が指定されている場合はそれを使用、なければインタビューで確認 - 制約: 小文字、数字、ハイフンのみ（最大64文字） 2. **スキルタイプ**: - **リファレンス型**: 規約、パターン、スタイルガイドなどの知識を提供 - **タスク型**: 特定のアクションを実行するステップバイステップ指示 3. **説明（description）**: **推奨** - スキルの用途、使用タイミング、関連キーワードを簡潔に記述する - Claudeはこの説明を使ってスキルを自動適用するか判断するため、ユーザーが自然に言うキーワードを含めること - 全スキルの説明がコンテキストウィンドウの2%（フォールバック16,000文字）の予算を共有して常時読み込まれるため、簡潔に保つ - 技術用語は英語キーワードのまま含めるとマッチしやすい（例: code, deploy, test） - 例: "コードを図解と比喩で説明する。コードの仕組みの質問、コードベースの学習、「これはどう動く？」という質問時に使用。" - `disable-model-invocation: true` の場合、descriptionはコンテキストに載らないため、キーワードやトリガー文言は不要。用途の説明のみで十分 - 省略時はマークダウンコンテンツの最初の段落が使用される 4. **引数ヒント（argument-hint）**: オプション - `/` メニューのオートコンプリート時に表示されるヒント - 例: `[issue-number]`、`[filename] [format]` 5. **適用範囲**: - 個人（~/.claude/skills/）- 全プロジェクトで利用可能 - プロジェクト（.claude/skills/）- このプロジェクトのみ - モノレポではサブディレクトリ内の `.claude/skills/` からも自動検出される #### 呼び出し制御 6. **呼び出し方法**: - **手動のみ**（`disable-model-invocation: true`）: ユーザーのみが `/skill-name` で呼び出し可能 - 判断基準: デプロイ、メッセージ送信、Git操作、ファイル削除など**副作用のあるワークフロー**。タイミングをユーザーが制御すべきスキルに使う - 注意: descriptionはコンテキストに載らないため、キーワード最適化は不要 - **自動＋手動**（デフォルト）: Claudeが関連時に自動ロード、ユーザーも手動で呼び出し可能 - 判断基準: コーディング規約、API規約、説明スキルなど、**会話の文脈で自動適用されると便利なスキル**。大半のスキルはこれでよい - **Claude専用**（`user-invocable: false`）: `/` メニューに非表示 - 判断基準: レガシーシステムの知識やドメイン固有の背景情報など、**ユーザーが直接呼び出すアクションではないバックグラウンド知識**向け #### 実行環境 7. **実行コンテキスト**: - **インライン**（デフォルト）: メイン会話内で実行。会話コンテキストにアクセス可能 - 判断基準: 会話の流れに沿って動くスキル。リファレンス型や、会話コンテキストが必要な軽量タスク型 - **サブエージェント**（`context: fork`）: 分離されたコンテキストで実行。会話履歴にアクセス不可 - 判断基準: 重い処理（リサーチ、大量分析）や、**メインの会話コンテキストを消費したくない場合**に使う - 注意: ガイドラインのみで実行タスクがないスキルには不向き（サブエージェントが何もせず戻る） 8. **サブエージェントタイプ**（`context: fork` 時のみ）: - `Explore`（読み取り専用探索）/ `Plan`（設計・計画）/ `general-purpose`（デフォルト）/ カスタム（`.claude/agents/` で定義） 9. **モデル指定（model）**: オプション - スキル実行時に使用するモデルを指定 #### ツールとファイル 10. **必要なツール（allowed-tools）**: オプション（**設定忘れ注意**） - スキルがアクティブな時にClaudeが許可なく使用できるツール - **未設定だとスキル実行中にツール使用の都度ユーザー許可が必要になり、スキルの自動実行が阻害される** - スキルの指示内容で使うツールを洗い出して設定すること - 例: `Read, Grep, Glob`（読み取り専用）、`Bash(gh:*)`（GitHub CLI限定）、`WebFetch, Read, Write, Edit, Glob`（ファイル操作＋Web取得） 11. **サポートファイル構成**: オプション - SKILL.md以外に含めるファイル: テンプレート、例、スクリプト、リファレンスなど - SKILL.mdは500行以下を推奨。詳細は別ファイルに分離 12. **フック（hooks）**: オプション - スキルのライフサイクルにスコープされたフック。詳細は [Hooks](https://code.claude.com/docs/ja/hooks) を参照 ### Step 3-2: 高度な機能確認（該当する場合のみ） #### 拡張思考（ultrathink） スキルで拡張思考を有効にしたい場合、SKILL.mdコンテンツ内のどこかに「ultrathink」という単語を含める。これにより、Claudeはより深い思考プロセスを使用してタスクを処理する。 #### 変数置換 スキルコンテンツ内で使用可能な変数: | 変数 | 説明 | |------|------| | `$ARGUMENTS` | スキル呼び出し時に渡された全引数文字列。コンテンツに存在しない場合は末尾に `ARGUMENTS: ` として追加 | | `$ARGUMENTS[N]` | N番目の引数（0始まり）。例: `$ARGUMENTS[0]` は最初の引数 | | `$N` | `$ARGUMENTS[N]` の短縮形。`$0` は最初の引数、`$1` は2番目 | | `${CLAUDE_SESSION_ID}` | 現在のセッションID。ログやセッション固有のファイル作成に有用 | #### 動的コンテキスト注入 シェルコマンドの実行結果をスキルコンテンツに注入する機能。エクスクラメーションマーク（!）の直後にバッククォートで囲んだコマンドを記述する。これはプリプロセッシングとして動作し、Claudeが見る前にコマンド出力がプレースホルダーを置換する。 SKILL.md内にサンプルコードを記述するとパーサーが検出・実行するため、直接記述は避けること。詳細は [公式ドキュメント](https://code.claude.com/docs/ja/skills#inject-dynamic-context) を参照。 #### ビジュアル出力パターン スクリプトをバンドルしてHTMLなどのビジュアル出力を生成可能: ```text my-skill/ ├── SKILL.md └── scripts/ └── visualize.py # Claudeが実行するスクリプト ``` #### プランモード連携 タスク型スキルで実装を伴う複雑なワークフローの場合、スキル本文にプランモード解除ステップを組み込むか確認する： - **含める場合**: スキル本文の先頭（最初のステップの前）に以下の文言をそのまま追加する ``` ## Step 0: プランモード解除 プランモードが有効な場合は、ExitPlanMode ツールを呼び出して解除してください。 プランモードでない場合はこのステップをスキップしてください。 ``` - **含めない場合**: スキルが直接実行のみのワークフローであれば不要 判断基準: - 実装の方針が複数ありうる → 含める（ユーザーがアプローチを選べる） - 手順が決まっている直接実行型 → 不要 ### Step 3-3: スキル作成実行 作成前チェック: - allowed-tools がスキルの指示内容で使うツールを網羅しているか確認。不足があればユーザーに提案する - フロントマター値にクオート（`"` `'`）が含まれていないか確認 実行: 1. 指定されたディレクトリにスキルフォルダを作成 2. SKILL.mdファイルを生成 3. サポートファイルがある場合は作成 4. 作成したファイルの内容を表示 ## Step 4: 更新フロー ### Step 4-1: 対象スキルの特定 - `$ARGUMENTS[1]` でスキル名が指定されている場合: 以下のパスを Glob で検索し SKILL.md を探す - `.claude/skills/*/SKILL.md` - `~/.claude/skills/*/SKILL.md` - `**/plugins/*/skills/*/SKILL.md` - 未指定の場合: 上記すべてのパスからスキル一覧を収集し、AskUserQuestion で対象を選択させる ### Step 4-2: 現在の設定の読み込みと表示 対象の SKILL.md を Read で読み込み、以下を整理して表示する: - **フロントマター設定一覧**: 各フィールドの現在値 - **本文概要**: 見出し構成と行数 - **サポートファイル一覧**: 同ディレクトリ内の SKILL.md 以外のファイル（Glob で検索） ### Step 4-3: 更新箇所の選択 AskUserQuestion（multiSelect: true）で更新したい箇所を選択させる: - **フロントマター設定**（name, description, argument-hint, allowed-tools など） - **本文（スキル指示内容）** - **サポートファイル**（テンプレート、スクリプトなど） - **高度な機能**（変数置換、動的コンテキスト注入、ultrathink、プランモード連携 など） ### Step 4-4: 選択項目の更新インタビュー 選択された項目について、現在の値を表示しながら変更内容を確認する: - **フロントマター**: 各フィールドの現在値を提示し、変更したいフィールドのみ新しい値を確認。変更のない部分はそのまま保持 - **本文**: 現在の構成を示しつつ、具体的な変更指示を確認。全面書き換えか部分修正かを確認 - **サポートファイル**: 追加・変更・削除の対象を確認 - **高度な機能**: Step 3-2 のリファレンスを参照しながら、追加・変更する機能を確認 ### Step 4-5: 更新実行 1. 変更内容のプレビューを表示（変更前 → 変更後の diff 形式） 2. AskUserQuestion で適用確認 3. 変更を反映: - フロントマターのみの変更 → Edit で部分更新 - 本文の部分修正 → Edit で部分更新 - 大幅な書き換え → Write で全体更新 - サポートファイル → Write / Edit で個別に更新 4. 更新結果を表示 ## フロントマター記述ルール **クオート（引用符）は使用しない。** フロントマターはYAML風の記法だが、YAMLパーサーではない。値にダブルクォート（`"`）やシングルクォート（`'`）を付けてはいけない。コロン、カンマ、特殊文字を含む値であっても、クオートなしでそのまま記述すること。 - OK: `description: コードを図解と比喩で説明する。コードの仕組みの質問時に使用。` - NG: `description: "コードを図解と比喩で説明する。コードの仕組みの質問時に使用。"` ## フロントマターリファレンス ```yaml --- name: my-skill # スキル名（省略時はディレクトリ名） description: What this skill does # 説明（推奨） argument-hint: [arg1] [arg2] # 引数ヒント disable-model-invocation: true # Claude自動呼び出し無効化 user-invocable: false # /メニューから非表示 allowed-tools: Read, Grep, Glob # 許可ツール model: sonnet # 使用モデル context: fork # サブエージェント実行 agent: Explore # サブエージェントタイプ hooks: # ライフサイクルフック pre-tool-execution: - command: echo "Starting" --- ``` ## 引数 - `/edit-skill create my-new-skill`: スキル名を指定して新規作成 - `/edit-skill create`: インタビューでスキル名を確認して新規作成 - `/edit-skill update my-existing-skill`: スキル名を指定して更新 - `/edit-skill update`: スキル一覧から選択して更新 - `/edit-skill`: サブコマンド選択から開始 --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/kentanakae) — claim your Tome and manage your conversions.