microsoft-excel — скилл для Claude Code: Excel в OneDrive
Читает и правит рабочие книги Excel в OneDrive и SharePoint через Microsoft Graph: диапазоны, таблицы, листы. Токен нужен в $MICROSOFT_EXCEL_TOKEN.
Apache-2.0 187 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill microsoft-excel -a claude-codeЧто делает microsoft-excel
Скилл ходит в облачные книги через Graph workbook API, запросы идут из Bash через curl и jq. Сначала файл находится поиском по OneDrive, его id становится ITEM_ID. Дальше можно перечислить листы, забрать usedRange или конкретный адрес вроде A1:C5.
Запись — это PATCH по адресу диапазона: значения подаются двумерным массивом, который совпадает по форме с адресом. Новая строка в таблицу уходит POST в tables/Table1/rows/add. Перед правкой скилл просит подтверждение. Ошибки приходят объектом с полями code и message, сообщение показывается как есть.
Токен берётся из $MICROSOFT_EXCEL_TOKEN. Истёк — ответ 401, коннектор надо переустановить. 403 на записи значит, что выдан только Files.Read. Локальный .xlsx, загруженный в чат, этим скиллом не открыть: его разбирают напрямую. Для долгих серий правок Graph поддерживает заголовок workbook-session-id, для пары ячеек хватает обычного режима.
Какие задачи решает
- прочитать usedRange из книги на OneDrive
- дописать строку в таблицу
Table1 - обновить ячейки
A2:B3без скачивания файла - перечислить листы и понять, где лежат данные
- найти книгу по имени и получить её
ITEM_ID
Примеры запросов агенту
- Покажи, что лежит в
usedRangeлистаSheet1вbudget.xlsxна OneDrive - Допиши в
Table1строку с датой 2026-06-21, клиентом Acme и суммой 4200 - Перечисли листы в книге и скажи, на каком лежит отчёт за квартал
Как установить microsoft-excel
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-excel -a claude-code2Вручную: положить файлы
~/.claude/skills/microsoft-excel/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/microsoft-excel/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-excel -a codex2Вручную: положить файлы
.agents/skills/microsoft-excel/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-excel -a cursor2Вручную: положить файлы
.cursor/skills/microsoft-excel/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/microsoft-excel2Вручную: положить файлы
.github/skills/microsoft-excel/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-excel -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/microsoft-excelВручную: положить файлы
.devin/skills/microsoft-excel/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill microsoft-excel -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о microsoft-excel
Как установить microsoft-excel в Claude Code?
Запустите npx skills add AceDataCloud/Skills --skill microsoft-excel -a claude-code. Скилл окажется в ~/.claude/skills/microsoft-excel/SKILL.md.
Что делает microsoft-excel?
Читает и меняет живые книги Excel в OneDrive и SharePoint через Microsoft Graph: диапазоны, ячейки, строки таблиц, список листов. Работает из Bash через curl и jq.
Что нужно, чтобы скилл заработал?
OAuth-токен в $MICROSOFT_EXCEL_TOKEN и доступ Files.ReadWrite — при одном Files.Read запись вернёт 403. Истёкший токен даёт 401, тогда коннектор переустанавливают.
Исходный текст
SKILL.md · Apache-2.0
---
name: microsoft-excel
description: Read and edit live Excel workbooks stored in OneDrive / SharePoint via the Microsoft Graph workbook API. Use when the user mentions an Excel file, a spreadsheet on OneDrive, reading a range or table, appending rows, updating cells, or listing worksheets in a cloud .xlsx.
when_to_use: |
Trigger when the user wants to read or write a cloud Excel workbook
(one that lives in their OneDrive / SharePoint) — read a used range,
read/update cells, add rows to a table, list worksheets. The
connector grants `Files.ReadWrite` (or `Files.Read` read-only). Find
the file id first via OneDrive search; confirm before writes.
connections: [microsoft/excel]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
---
Drive **live Excel workbooks** via the Microsoft Graph workbook API with
`curl + jq`. The user's OAuth bearer token is in `$MICROSOFT_EXCEL_TOKEN`; every
call needs `Authorization: Bearer $MICROSOFT_EXCEL_TOKEN`. Base URL:
`https://graph.microsoft.com/v1.0`. The workbook API operates on a **drive item**
(an .xlsx in OneDrive/SharePoint), so you need its `ITEM_ID`.
Failures are `{"error":{"code","message"}}` — show `message` verbatim. `401` =
token expired (re-install). `403` on a write = the user granted read-only.
```bash
G="https://graph.microsoft.com/v1.0"; AUTH="Authorization: Bearer $MICROSOFT_EXCEL_TOKEN"
# Find the workbook by name (then take .id as ITEM_ID)
curl -sS -H "$AUTH" "$G/me/drive/root/search(q='budget.xlsx')" \
| jq '.value[] | {id, name, webUrl}'
# Worksheets in the workbook
curl -sS -H "$AUTH" "$G/me/drive/items/ITEM_ID/workbook/worksheets" \
| jq '.value[] | {id, name, position}'
```
## Read & write ranges
```bash
ITEM="ITEM_ID"; WS="Sheet1"
# Used range (values + formulas + formats)
curl -sS -H "$AUTH" \
"$G/me/drive/items/$ITEM/workbook/worksheets/$WS/usedRange" \
| jq '{address, values: .values}'
# Read a specific range
curl -sS -H "$AUTH" \
"$G/me/drive/items/$ITEM/workbook/worksheets/$WS/range(address='A1:C5')" | jq '.values'
# Update a range (confirm first). values is a 2-D array matching the address shape.
curl -sS -X PATCH -H "$AUTH" -H "Content-Type: application/json" \
-d '{"values":[["Q3",1200],["Q4",1580]]}' \
"$G/me/drive/items/$ITEM/workbook/worksheets/$WS/range(address='A2:B3')" | jq '.address'
```
## Append a row to a table
```bash
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
-d '{"values":[["2026-06-21","Acme",4200]]}' \
"$G/me/drive/items/$ITEM/workbook/tables/Table1/rows/add" | jq '.index'
```
## Gotchas
- This is for **cloud** workbooks (OneDrive/SharePoint). A local .xlsx the user
uploaded into chat is a different job (parse the file directly), not this skill.
- Range `address` is a string like `Sheet1!A1:C5` or just `A1:C5` when scoped to a
worksheet; `values` must be a 2-D array matching its dimensions.
- For long-running edits Graph supports a **workbook session** header
(`workbook-session-id`); for a few cells the default sessionless mode is fine.
© acedatacloud · Apache-2.0 · AceDataCloud/Skills