| name | macos-numbers |
| description | Use this skill when you need to read or edit Apple Numbers spreadsheets on macOS through AppleScript entrypoints that return JSON. |
macOS Numbers
Use this skill when the task is about Apple Numbers.app on macOS.
Main Rule
Use only scripts/commands.
Do not call scripts/applescripts directly.
Requirements
- macOS with Numbers.app
- Automation permissions for the terminal.
Public Interface
Run commands from scripts/commands:
scripts/commands/document/*scripts/commands/table/*
Output Rules
- Commands return JSON by default.
--json, --plain, and --format=plain|json are not supported.
Commands
Document
scripts/commands/document/read.sh <path>
scripts/commands/document/create.sh <path> <json-structure>
scripts/commands/document/structure.sh <path>
Table
scripts/commands/table/read.sh <path> <sheet-name> <table-name>
scripts/commands/table/append.sh <path> <sheet-name> <table-name> <json-rows>
scripts/commands/table/write.sh <path> <sheet-name> <table-name> <json-cells>
JSON Contract
Document object:
name (string)path (string)sheets_count (integer)
Table object:
name (string)rows (integer)columns (integer)headers (list of strings)
Cell object:
row (integer, 0-based)column (integer, 0-based)value (string or number)
Scalar envelopes:
success/failure: {"success": true/false, "error": "..."}
Safety Boundaries
- File writes must be explicit.
- Internal AppleScript files are not public API.
