Claude xlsx スキル使い方｜Excel自動化と数式検査

xlsx スキルの使い方：Excel 自動化と数式エラー検査

3つの導入手順から recalc.py での検査、納品前の確認点まで

anthropics/skills の xlsx スキルで、数式が生きた Excel をエージェントに作らせる方法が分かります。3つの導入手順、主な規則、recalc.py でのエラー検査、納品前に人が確認すべき点まで整理しました。

2026.11.095分で読めますエンジニア・ビジネス向け難しさ：初級AIexandria編集部

anthropics/skills の xlsx スキルでできること

xlsx スキルを使うと、Claude などのエージェントに数式が生きた Excel ファイルを作らせ、数式エラーの検査まで任せられます。使い始める方法は、Claude アプリの設定、Claude Code のプラグイン、npx skills の3つです。規則の中心は「計算結果を直接書き込まず数式を使う」「recalc.py で数式エラーをなくす」の2点です。ただし、エラーがなくても数式が正しいとは限らないため、納品前に人の確認が必要です。

xlsx スキルは anthropics/skills に含まれ、ライセンスは Apache 2.0 です。同リポジトリのスター数は2026年11月9日時点で約19万です。Agent Skills は、SKILL.md を含むフォルダで手順や知識をエージェントに渡すオープンな形式です。

Claude アプリ、Claude Code、npx skills での使い始め方

Claude アプリ（2026年11月時点）

ヘルプによると、組み込みスキルは Free から Enterprise までの各プランで使えます。

設定の Capabilities で「Create and edit files」をオンにします。
Customize > Skills で Excel スキルをオンにします。
チャットで Excel ファイルの作成を依頼します。関連する依頼なら自動で使われます。

Enterprise では、オーナーが Organization settings > Plugins & skills の Policy タブでコード実行とスキルを有効にします。ファイルの上限は1件30MBです。外部ファイルに仕込まれた指示でデータが外部へ送られる恐れもあるため、ヘルプは動作の監視を勧めています。

Claude Code

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

npx skills

Vercel Labs の CLI で、xlsx だけを導入できます。

npx skills add anthropics/skills --skill xlsx -a claude-code

既定の導入先は現在のプロジェクトで、Claude Code なら .claude/skills/ です。-g を付けるとプロジェクトをまたいで使えます。

スキルは openpyxl、pandas、markitdown の導入済み環境を前提に書かれています。ローカルでは、これらと再計算に使う LibreOffice の有無を確認してください。

数式で書くなど、xlsx スキルの主な規則

以下は GitHub 版 SKILL.md の内容です。

規則	内容
数式を使う	Python で計算した合計を書き込まず、`=SUM(B2:B9)` のように入れる
数式を失わない	`data_only=True` で開いて保存すると、数式が値に置き換わる
指定を守る	指定されたシート名、列見出し、数式をそのまま使う
根拠を残す	前提と直書きした数値を、セルコメントか隣接セルに記載する

財務モデルでは、入力値を青、数式を黒、他シート参照を緑、外部リンクを赤の文字にします。重要な前提には黄色の塗りを使います。

XLOOKUP など新しい関数を避ける制約

スキルは XLOOKUP、XMATCH、SORT、FILTER、UNIQUE、SEQUENCE を禁じています。openpyxl の出力にはスピル（結果を複数セルへ自動展開する動作）の情報がなく、左上のセルにしか値が入らないためです。このとき recalc.py はエラー0件と返します。

検索は INDEX と MATCH で代替し、並べ替えや重複除去は Python で処理してからセルに書きます。TEXTJOIN や IFS などは _xlfn. を付けないと #NAME? になります。

集計表や財務モデルを頼むときの指示の出し方

スキルは指定されたシート名や見出しを優先します。そこで、構成と検証の報告内容を先に決めて伝えます。

sales.csv から月次売上の集計表を xlsx で作ってください。
シートは Data と Summary の2つです。
Summary の行は地域、列は月とし、SUMIFS で集計します。
完了後に recalc.py を実行し、出力 JSON と、
元データで検算したセル3つの値を報告してください。

財務モデルでは、成長率などの前提を入力セルに分けるよう指示します。スキルの通貨形式の例は $#,##0 なので、円なら明示します。

recalc.py で数式エラーをなくす手順

openpyxl は数式の計算結果を保存しません。そこで recalc.py が LibreOffice で再計算し、結果をファイルに上書きします。

python scripts/recalc.py output.xlsx 60 を実行します。末尾は秒単位の制限時間で、既定は30秒です。
JSON の status を確認します。
errors_found なら、error_summary の種類とセル位置をもとに修正し、再実行します。
success になるまで納品しません。

検出対象は #VALUE!、#DIV/0!、#REF!、#NAME?、#NULL!、#NUM!、#N/A です。CI では注意が必要です。終了コードが非ゼロになるのは主に再計算自体が失敗したときで、errors_found でも0を返します。判定には status を使ってください。

納品前に人が確認すべき点

recalc.py が示すのは数式を評価できたことで、正しさではありません。範囲のずれや誤った行の参照は検出されません。次の点は人が確かめます。

合計や主要な指標が、元データや別の方法で求めた値と一致するか
入力値を変えると、結果が想定どおりに変わるか
前提と数値の出典が記載され、妥当か
実際の Excel で開いても、表示と計算結果に問題がないか

xlsx スキルの対象外の作業と注意点

スキルの説明は、主な成果物が Word 文書、HTML レポート、単独の Python スクリプト、データベースパイプライン、Google Sheets API 連携なら起動しないと定めています。

外部ブックへのリンクにも注意が必要です。openpyxl で保存するとキャッシュ値が消えるため、recalc.py はこの状態での実行を拒否します。--force で実行するとリンクは失われるので、先に元ファイルから値を移してください。