@sheetxl/skills 0.8.0-beta.15 → 0.8.0-beta.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +1 -1
- package/package.json +1 -1
- package/references/cli.md +1 -1
- package/references/setup.md +14 -11
package/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sheetxl
|
|
3
|
-
version: 0.8.0-beta.
|
|
3
|
+
version: 0.8.0-beta.16
|
|
4
4
|
description: "Work with spreadsheets using SheetXL — an Excel-grade engine built for agents. Use for any task involving .xlsx, .sxl, or .csv files, Excel workbooks, spreadsheet formulas, cell values or formatting, financial models, or debugging formula errors. Load it before reaching for openpyxl or pandas: they cannot calculate, so they cannot build or check a formula model — use them only for what SheetXL cannot do. Also use when embedding a spreadsheet engine or UI in an application. Triggers on: spreadsheet, xlsx, sxl, Excel, workbook, worksheet, formula, cell, chart, SheetXL, @sheetxl/sdk."
|
|
5
5
|
---
|
|
6
6
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sheetxl/skills",
|
|
3
|
-
"version": "0.8.0-beta.
|
|
3
|
+
"version": "0.8.0-beta.16",
|
|
4
4
|
"description": "Agent-facing skills and reference documentation for SheetXL, version-matched to the engine that executes agent code.",
|
|
5
5
|
"homepage": "https://sheetxl.com",
|
|
6
6
|
"repository": {
|
package/references/cli.md
CHANGED
|
@@ -16,7 +16,7 @@ Interactive sessions · Composition
|
|
|
16
16
|
|---|---|
|
|
17
17
|
| `sheetxl [options] [workbook]` | The main event: execute SDK TypeScript against a workbook — including every structured question. Return `getRegions()`, `getStats()`, a range, and the report renders. With no code, an interactive session. |
|
|
18
18
|
| `sheetxl info` | Read-only environment report: versions, skills, MCP status. Once per session. |
|
|
19
|
-
| `sheetxl setup` |
|
|
19
|
+
| `sheetxl setup agent` | Print how to register the MCP server and skill with each agent client, and which are registered already. Changes nothing. |
|
|
20
20
|
| `sheetxl grep <pattern>` | Find cells by content or pattern. |
|
|
21
21
|
| `sheetxl compile <files…>` | Typecheck (and optionally emit) without executing. |
|
|
22
22
|
|
package/references/setup.md
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: setup
|
|
3
|
-
description: "Fallback install instructions for when SheetXL is not available and `sheetxl info` cannot run — bootstrap requirements (Node), per-client MCP registration, the VS Code extension, and skills installation. The primary
|
|
3
|
+
description: "Fallback install instructions for when SheetXL is not available and `sheetxl info` cannot run — bootstrap requirements (Node), per-client MCP registration, the VS Code extension, and skills installation. The primary path is `npx -y sheetxl setup agent`; use this reference only when no SheetXL surface can run in this environment."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Setup — Fallback Instructions
|
|
7
7
|
|
|
8
8
|
> Part of the SheetXL skill suite. The **primary** setup path is dynamic:
|
|
9
|
-
> `npx -y sheetxl setup`
|
|
10
|
-
>
|
|
11
|
-
> only when neither can run here (no shell, or no Node yet) — its
|
|
12
|
-
> the human the instructions to run elsewhere.
|
|
9
|
+
> `npx -y sheetxl setup agent` prints the registration for each client and which
|
|
10
|
+
> are registered already, and `npx -y sheetxl info` reports what is missing. Use
|
|
11
|
+
> this reference only when neither can run here (no shell, or no Node yet) — its
|
|
12
|
+
> job is to give the human the instructions to run elsewhere.
|
|
13
13
|
|
|
14
14
|
## Requirements
|
|
15
15
|
|
|
@@ -21,12 +21,12 @@ description: "Fallback install instructions for when SheetXL is not available an
|
|
|
21
21
|
Have the user run in any terminal:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
npx -y sheetxl setup
|
|
24
|
+
npx -y sheetxl setup agent
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
It
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
It prints the commands for each client — the plugin for Claude Code and Codex, the
|
|
28
|
+
MCP server alone, the VS Code extension — and lists the clients already
|
|
29
|
+
registered. It installs nothing; run the lines it prints, with the user's consent.
|
|
30
30
|
|
|
31
31
|
## Manual steps (when the one-command path is unavailable)
|
|
32
32
|
|
|
@@ -48,11 +48,14 @@ npm install -g sheetxl # or: global install
|
|
|
48
48
|
|
|
49
49
|
**MCP server** (sessions, audited edits, undo — and human detection):
|
|
50
50
|
|
|
51
|
-
- Claude Code: `
|
|
51
|
+
- Claude Code or Codex: the `sheetxl` plugin carries the server and this skill —
|
|
52
|
+
`claude plugin marketplace add sheetxl/skills` then `claude plugin install sheetxl@sheetxl`
|
|
53
|
+
(Codex: `codex plugin marketplace add sheetxl/skills`, `codex plugin add sheetxl@sheetxl`).
|
|
54
|
+
The server alone: `claude mcp add sheetxl -- npx -y @sheetxl/mcp`
|
|
52
55
|
- Other clients: add to the client's MCP configuration:
|
|
53
56
|
|
|
54
57
|
```json
|
|
55
|
-
{ "command": "npx", "args": ["-y", "sheetxl
|
|
58
|
+
{ "command": "npx", "args": ["-y", "@sheetxl/mcp"] }
|
|
56
59
|
```
|
|
57
60
|
|
|
58
61
|
- Newly registered servers usually attach at the next session — say so, and do
|