Claude Code の公式 xlsx スキルを読む——表計算をAIに任せる前に知る決まりごと

 文・監修:宮本 太郎

Claude Code には、Excel ファイルの作成や編集の手順をまとめた、Anthropic 公式の「xlsx スキル」が公開されています。本稿では、このスキル本体に書かれた決まりごとを出典に沿って読み、導入方法と、医療・ヘルスケアの現場で使うときの注意点をまとめます。

結論:xlsx スキルは「計算結果ではなく数式を残す」ための手順書です

Claude Code の「スキル」は、特定の作業のやり方をまとめた手順書のようなものです。Anthropic は GitHub の公開リポジトリ(anthropics/skills)でいくつかのスキルを公開しています。その中の xlsx スキルは、表計算ファイルを扱うときの決まりごとをまとめたものです。

先に要点を書きます。

  • スキル本体(SKILL.md)は、計算した結果の値を直接書き込まず、数式を書くよう求めています。
  • 数式を含むファイルは、付属のスクリプトで再計算してから渡す決まりです。数式のエラーが報告されている間は出力しない、とされています。
  • そのうえで、再計算が通ったことは「数式が計算できる」ことを示すだけで、「数式が正しい」ことの証明にはならない、と明記しています。
  • このスキルは「ソース公開(source-available)」の扱いで、オープンソースではありません。リポジトリ全体には、デモと学習のために提供しているものだという注意書きがあります。

人事・健康管理の担当者が集計表をAIに作らせる場面や、医療AIの開発で検証用の表を作る場面で、知っておくと判断しやすくなる内容です。

導入方法:公開リポジトリをマーケットプレイスとして登録する

anthropics/skills リポジトリの説明では、Claude Code で次のコマンドを実行すると、このリポジトリをプラグインの「マーケットプレイス」(配布元の一覧)として登録できるとされています。

/plugin marketplace add anthropics/skills

そのあと、画面で「Browse and install plugins」から anthropic-agent-skills を選び、document-skills または example-skills を選んでインストールします。次のように直接インストールすることもできます。

/plugin install document-skills@anthropic-agent-skills

xlsx スキルは、docx・pdf・pptx のスキルと同じく、文書を作成・編集するためのスキル群に入っています。

Claude Code の公式ドキュメントでは、プラグインを入れる前に詳細画面で「何が追加されるか(Will install)」を確認できると説明しています。プラグインはフックや MCP サーバー(外部の道具と連携する仕組み)を動かせるので、インストール前にこの画面を読むよう促しています。インストールの範囲は、自分のすべてのプロジェクト(ユーザー)、そのリポジトリを使う全員(プロジェクト)、自分だけかつそのリポジトリだけ(ローカル)から選べます。チームで使うなら、誰の環境に何が入るのかを先に決めておくと混乱を防ぎやすくなります。

スキル本体に書かれている主な決まりごと

SKILL.md に書かれている内容のうち、実務で特に関係するものを紹介します。

数式を使い、計算結果を書き込まない。 たとえば合計欄には、Python で計算した値ではなく =SUM(...) のような数式を書くよう指示しています。理由は、入力値が変わったときに表が再計算されるようにするためです。健診の受診者数や面談件数の集計表のように、元のデータがあとから直される表では大事な考え方です。

再計算してから渡す。 スキルによると、openpyxl(Python で Excel を扱う部品)で書いた数式には、計算済みの値が入っていません。再計算するまでは、pandas などで読むと数式のセルが空(None)に見えます。そのため付属の recalc.py で再計算し、その結果が errors_found を返している間は出力しないよう定めています。

元からあったエラーかどうかは確かめてから言う。 エラーが元のファイルにあったものだと思う場合は、元のファイルを開いてそのセルを確認するよう求めています。自分で持ち込んだエラーと、もともとあったエラーは見た目では区別できない、という書き方です。

再計算が通っても、数式が正しいとは限らない。 冒頭にも書いたとおり、スキルは、再計算が通ったことは数式が「計算できる」ことの証明でしかない、と明記しています。参照する範囲がずれている、条件が逆になっている、といった誤りは、エラーが出なくても残ります。

使える関数に気をつける。 再計算には LibreOffice(無料の表計算ソフト)を使います。スキルは、LibreOffice は Excel より使える関数が少ないとして、SUMIFS・INDEX・MATCH・IFERROR・SUMPRODUCT などを使い、XLOOKUP・FILTER・UNIQUE などは使わないよう指示しています。社内で新しい関数を前提にした表を使っている場合は、AIが作る表と書き方が違ってくることがあります。

このほか、財務モデルでは入力値・数式・他シートへの参照を文字色で分ける、といった色分けの決まりも書かれています。

医療・ヘルスケアの業務で使うときの注意点

患者情報や従業員の健康情報を入れない。 健診結果やストレスチェックの結果、面談記録などをそのまま外部のAIに渡す使い方はお勧めしません。表の構造や数式を作る段階では、架空のデータ(ダミーデータ)で雛形を作り、実データは組織の規程に沿った環境で流し込む、という分け方が無難です。

「エラーが出ない」を合格の基準にしない。 スキル自身が書いているとおり、再計算が通ることと集計が正しいことは別の話です。数件の手計算と照らし合わせる、合計が元の名簿の人数と合うか確かめる、といった人による点検を残しておくことが大切です。

公式の機能と同じ動きをするとは限らない。 リポジトリには、これらのスキルはデモと学習のためのもので、Claude で実際に得られる動作とは異なる場合がある、という注意書きがあります。重要な業務に使う前に、自分の環境で十分に試すよう求めています。

ライセンスを確認する。 xlsx スキルはソース公開であり、オープンソースではありません。SKILL.md にはライセンスが「Proprietary」と書かれ、詳細は同梱の LICENSE.txt を参照するよう示されています。自社製品に組み込んだり改変して配ったりする場合は、条件を先に確認してください。

読むだけでも役に立つ「手順書」として

xlsx スキルは、入れて使うだけのものではありません。AIに表計算を任せるとき、どこで誤りが入りやすいのか、何を確かめれば足りて何が足りないのかが書かれた資料として読む価値があります。とくに「再計算が通っても数式が正しいとは限らない」という一文は、AIを使った集計だけでなく、検証の仕組みを作るときにも参考になる考え方です。

当社では、医療・産業保健の現場でAIを業務に組み込む際の進め方や、検証の設計についてのご相談をお受けしています。お気軽にご相談ください。

まずはお気軽にご相談ください

「AIで何かできそうだが、何から始めればよいか分からない」段階からのご相談を歓迎します。医師×AIの視点で、貴社の課題に合ったアプローチをご提案します。