mcpField
E
excel-sheet

excel-sheet

github.com/practicalswanドキュメント2239 回インストール1 週間前に更新
リポジトリ

excel-sheet について

Excel ワークブックの作成・更新を扱うワークフロースキルです。CSV 変換、数式、書式、グラフ、ピボットテーブルに対応し、Excel MCP ツールの有無を確認したうえで、ローカル自動化と検証の手順も示します。

主な機能

  1. 01ワークブックの作成と更新
  2. 02CSV から XLSX への変換
  3. 03数式、書式、グラフの処理
  4. 04MCP の可用性確認とローカル代替手段
  5. 05ワークブックの検証手順

活用シーン

  1. 01CSV データを整形済みワークブックに変換
  2. 02数式、グラフ、ピボットテーブルの更新
  3. 03ワークブックの構造と書式の検証

MCP 対応

利用中のクライアントに Excel MCP ツールがあるか、先に確認することを推奨しています。利用できない場合は、`openpyxl`、`scripts/csv-to-xlsx.py`、デスクトップ版 Excel などのローカル手段を案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/practicalswan/agent-skills --skill excel-sheet

インストール後、Claude Code で/excel-sheetを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
LICENSE.txt
examples/
excel-workbook-examples.md
references/
excel-formulas-reference.md
scripts/
csv-to-xlsx.py

詳細

Excel スプレッドシートのワークフロー

対象となる技術スタック／バージョン：Excel デスクトップ版、または現在の OOXML 互換ワークフローに対応した openpyxl ベースのスプレッドシート自動化。

成果物が .xlsx ブックである場合、またはスプレッドシートの構造が重要な場合に、このスキルを使用してください。

  • 利用可能な場合は、ネイティブの並列サブエージェント呼び出しと 200k 以上のコンテキストウィンドウを活用してください。

現在の MCP の実情

Excel MCP ツールの利用可否はホストに依存します。GitHub Copilot では、Excel のアクションが Office ツールとしてグループ化されて表示される場合があります。Codex や Claude では、これらのツールがまったく使えない場合があります。付属の Python スクリプトを、信頼できる代替手段として扱ってください。

有効化条件

症状からアクションを判断してください。以下の条件のいずれかに当てはまる場合は、このスキルを適用し、以下のプロトコルに従って検証してください。

  • ブックを作成または更新する
  • CSV データを構造化された Excel 出力に変換する
  • 数式、書式、グラフ、ピボットテーブルを適用する
  • レイアウトが重要なスプレッドシート成果物を作成する

実用的なワークフロー

  1. クライアントでスプレッドシート用 MCP ツールが利用できるか確認します。
  2. 利用できる場合は、ラッパーの存在を決めつけず、実際のツール名を確認します。
  3. 利用できない場合は、ローカルのコンバーターを使用するか、openpyxl でブックを作成します。
  4. ブックの準備ができたと伝える前に、数式とグラフの範囲を検証します。

MCP の代替手段 – ネイティブ自動化

MCP が利用できない場合は、ネイティブの自動化を使用します。.xlsx には openpyxl、フラットデータには CSV エクスポートを使用し、リスクの高い計算式は手動で確認します。数式、数値書式、シート名、非表示シート、ブックのメタデータを保持し、成功を伝える前にブックを再度開くか解析してください。

クライアント間の移植性

このスキルは、GitHub Copilot、Claude Code、Codex で利用できるように作成されています。

  • GitHub Copilot：フォルダー探索が利用できない場合は、Copilot から見えるスキルのパスにフォルダーを配置するか、ワークフローをプロジェクトの指示としてまとめてください。
  • Claude Code：フォルダーをローカルのスキルディレクトリまたは互換性のあるプラグインソースに配置してください。
  • Codex：フォルダーを $CODEX_HOME/skills/excel-sheet にインストールまたは同期し、大きな変更を加えた後は Codex を再起動してください。

MCP の利用可否と代替手段

優先する MCP サーバー：Excel MCP

  • 代替プロンプト："Use the Excel Spreadsheet Workflows skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence."
  • スプレッドシート MCP が利用できない場合は、scripts/csv-to-xlsx.py、openpyxl、またはデスクトップ版 Excel を使用してください。
  • 生成したブックをローカルで再度開き、数式、範囲、ウィンドウ枠の固定を検証してください。
  • アクティブなホストで MCP を利用できない場合、MCP 操作を使用したと主張してはいけません。

アンチパターン

  • 入力内容がすでに整っていると見なす：書式の自動化は、壊れた入力や一貫性のない入力もそのまま保持してしまいます。
  • ファイルを開いて検証する工程を省く：ドキュメントやスプレッドシートは、スクリプトの出力ではなく、出力先アプリで問題が起きることがよくあります。
  • チェックポイントを設けずに取り消せない編集を自動化する：小さなマッピングミスが、ブックやドキュメント全体に影響することがあります。

検証プロトコル

「スキルを正常に適用しました」と伝える前に、次の項目を確認してください。

  1. 合否：編集前に、Excel シートの成果物の種類、対象形式、必要な出力の忠実度が明示されている。
  2. 合否：MCP の利用可否が確認され、MCP が利用できない場合はネイティブ自動化の代替手段が明示されている。
  3. 合否：作成したファイルまたは数式が、ローカルで開く、解析する、レンダリングする、または別の方法で検証されている。
  4. 負荷テストのシナリオ：書式、メタデータ、または変換におけるエッジケースを含むファイルにワークフローを適用し、重要な情報が失われていないことを確認する。
  5. 成功指標：検証されていないドキュメントに関する主張がゼロであること。成果物そのものが証拠です。

ブックのチェックリスト

  • シート名が明確である
  • ヘッダーの書式に一貫性がある
  • 派生値をハードコードする代わりに数式を使用している
  • グラフが正しい範囲を参照している
  • 必要に応じてウィンドウ枠の固定やフィルターが適用されている

参考資料とリソース

ドキュメント
スクリプト
例

関連スキル

  • documentation-authoring：ワークフローで構造化された技術文書や製品ドキュメントの作成も必要な場合に使用します。
  • notion-docs：ワークフローで Notion ページやデータベースの公開も必要な場合に使用します。
  • pdf：ワークフローで PDF の抽出、生成、レイアウトを考慮したレビューも必要な場合に使用します。
  • word-document：ワークフローで Word 文書の作成や書式設定も必要な場合に使用します。

コメント

Markdown 対応