Agent skill

Apple Flow Numbers

by dkyazzentwatwa in dkyazzentwatwa/apple-flow

General Apple Numbers automation for Apple Flow. An agent skill from dkyazzentwatwa/apple-flow.

MITAuto-check passedDevelopment

Install Apple Flow Numbers

skills CLI
$ npx skills add dkyazzentwatwa/apple-flow --skill apple-flow-numbers -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dkyazzentwatwa/apple-flow apple-flow-numbers --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dkyazzentwatwa/apple-flow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/apple-flow-numbers .claude/skills/apple-flow-numbers && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-flow-numbers
GitHub stars
105
Token cost
~1.5k tokens
SKILL.md length
460 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

General Apple Numbers automation for Apple Flow. An agent skill from dkyazzentwatwa/apple-flow.

  • Works in 3 steps: Create a Numbers file with headers → Append rows (recommended default… → Verify insertion response
  • Working with .numbers files through apple-flow tools
  • SKILL.md covers Current Capability Snapshot, Quick Start, Input Rules and Position Strategy, plus 5 more sections
  • Calls osascript

What it does

Apple Flow Numbers is an agent skill from dkyazzentwatwa/apple-flow. General Apple Numbers automation for Apple Flow. Use when working with .numbers files through apple-flow tools, including creating new sheets, appending structured rows, choosing insertion behavior (after-data, after-headers, at-end), and validating/debugging row placement with read-back checks.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: Your Apple-Native AI Agent. The licence is MIT.

When your agent uses it

  • Working with .numbers files through apple-flow tools
  • Including creating new sheets
  • Appending structured rows
  • Choosing insertion behavior (after-data

Example prompts

  • “/apple-flow-numbers”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create a Numbers file with headers
  2. Append rows (recommended default after-data)
  3. Verify insertion response

What it can do on your machine

Read from SKILL.md and the folder at commit 4b9cf4f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • osascript

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Apple Flow Numbers loads about 1.5k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 460 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dkyazzentwatwa/apple-flow at commit 4b9cf4f, republished under its MIT licence (© dkyazzentwatwa). 460 words, ~1,490 tokens.

Download SKILL.mdSave it as .claude/skills/apple-flow-numbers/SKILL.md (or your agent's skills folder).
name
apple-flow-numbers
description
General Apple Numbers automation for Apple Flow. Use when working with `.numbers` files through `apple-flow tools`, including creating new sheets, appending structured rows, choosing insertion behavior (`after-data`, `after-headers`, `at-end`), and validating/debugging row placement with read-back checks.

Apple Flow Numbers

Use this skill to reliably create and update Apple Numbers documents with:

  • apple-flow tools numbers_create
  • apple-flow tools numbers_create_workbook
  • apple-flow tools numbers_add_sheet
  • apple-flow tools numbers_append_rows
  • apple-flow tools numbers_style_apply

Favor deterministic CLI workflows over ad hoc AppleScript. Use direct AppleScript only for read-back verification and debugging.

Current Capability Snapshot

  • Supports wide tables:
    • numbers_create auto-expands columns to fit all headers.
    • numbers_create_workbook builds multi-sheet files from one JSON spec.
    • numbers_add_sheet adds initialized sheets to existing workbooks.
    • numbers_append_rows auto-expands columns to fit the widest incoming row.
  • Supports insertion modes:
    • after-data, after-headers, at-end
  • Supports styling operations:
    • colors (background_color, text_color)
    • font (font_name, font_size)
    • alignment (left|center|right|justified|natural)
    • number format (automatic|currency|percentage|scientific|fraction|text)
    • wrapping (text_wrap)
    • dimensions (row_height, column_width)

Quick Start

  1. Create a Numbers file with headers:
bash
apple-flow tools numbers_create \
  "/abs/path/tracker.numbers" \
  '["Date","Item","Category","Amount","Notes"]' \
  --sheet "Sheet 1" \
  --table "Table 1" \
  --overwrite true
  1. Append rows (recommended default after-data):
bash
apple-flow tools numbers_append_rows \
  "/abs/path/tracker.numbers" \
  '[["2026-03-04","Coffee","Food",15,"Morning"],["2026-03-04","Burger","Food",30,"Lunch"]]' \
  --sheet "Sheet 1" \
  --table "Table 1" \
  --position after-data
  1. Verify insertion response:
  • Expect JSON with "ok": true
  • Check start_row and insert_after_row
  1. Apply formatting/style:
bash
apple-flow tools numbers_style_apply \
  "/abs/path/tracker.numbers" \
  '{"scope":"range","start_row":2,"end_row":20,"start_column":1,"end_column":5}' \
  '{"background_color":[255,245,230],"font_size":12,"alignment":"center","row_height":28,"column_width":160}'
  1. Build a full workbook (multiple sheets):
bash
apple-flow tools numbers_create_workbook \
  "/abs/path/workbook.numbers" \
  '{"sheets":[{"sheet_name":"Transactions","table_name":"Tx","headers":["Date","Item","Amount"],"rows":[["2026-03-04","Coffee",15]]},{"sheet_name":"Summary","table_name":"Summary","headers":["Metric","Value"],"rows":[["Total",15]]}]}' \
  --overwrite true
  1. Add one more sheet to an existing workbook:
bash
apple-flow tools numbers_add_sheet \
  "/abs/path/workbook.numbers" \
  '{"sheet_name":"Dashboard","table_name":"DashboardTable","headers":["Metric","Value"],"rows":[["Count",1]]}'

Input Rules

  • Always use an absolute path.
  • File extension must be .numbers.
  • numbers_create headers must be a JSON array of strings.
  • numbers_append_rows payload must be a JSON array.
  • numbers_create_workbook requires {"sheets":[...]} with unique sheet_name values.
  • numbers_add_sheet requires a sheet JSON object with sheet_name and non-empty headers.
  • Safest append shape: array-of-arrays (for example: [[...],[...]]).
  • numbers_style_apply target/style args must be JSON objects.
  • Style target indices are 1-based.

Position Strategy

  • after-data:
    • Best for logs and trackers.
    • Inserts right after the last non-empty data row.
    • Fills the top data region instead of jumping to visual bottom rows.
  • after-headers:
    • Inserts at first data row.
    • Shifts existing data down.
  • at-end:
    • Always appends to the physical end of the table.
    • Use when you explicitly want bottom append behavior.
Show full SKILL.md (184 more words)Show less

Wide-Column Imports

If a CSV has more than the default table width, import directly with full headers and rows. The tool will auto-add required columns before writing data.

Standard Workflow

  1. Define columns first.
  2. Create or reuse target file.
  3. Build rows as JSON.
  4. Append with --position after-data unless user asks otherwise.
  5. Verify first and last inserted rows.

Read-Back Verification

Use this AppleScript probe after appending:

bash
osascript <<'APPLESCRIPT'
set p to POSIX file "/abs/path/tracker.numbers"
tell application id "com.apple.iWork.Numbers"
  set d to open p
  set t to first table of first sheet of d
  tell t
    set firstRow to (value of cell 1 of row 2 as text) & "|" & (value of cell 2 of row 2 as text)
    set lastRow to (value of cell 1 of last row as text) & "|" & (value of cell 2 of last row as text)
  end tell
  close d saving no
  return firstRow & "\n" & lastRow
end tell
APPLESCRIPT

Troubleshooting

  • absolute path required:
    • Convert to absolute path before tool call.
  • target document does not exist:
    • Create with numbers_create first or confirm path typo.
  • Can't get sheet or Can't get table:
    • Provide exact --sheet and --table names.
  • Connection invalid / AppleScript runtime failures:
    • Ensure Apple Numbers is installed (com.apple.Numbers; older installs may use com.apple.iWork.Numbers) and automation permissions are granted.
    • Avoid similarly named non-iWork apps (for example Numbers Creator Studio.app) for AppleScript automation.
    • Retry command outside restrictive sandbox context when needed.
  • Rows appear too far down:
    • Use --position after-data and verify table has expected headers/data.

Done Criteria

  • Tool command returns "ok": true.
  • Inserted row range is sensible (start_row, insert_after_row).
  • Read-back confirms expected top and tail data placement.

© dkyazzentwatwa, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/apple-flow-numbers of dkyazzentwatwa/apple-flow.

Open the folder on GitHubat commit 4b9cf4f

Compare with similar skills

Apple Flow Numbers next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Flow Numbers compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Flow Numbers this skilldkyazzentwatwa/apple-flow105—~1.5kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from dkyazzentwatwa/apple-flow

  • Apple Flow Mail

    dkyazzentwatwa/apple-flow

    Deep workflow skill for Apple Flow Mail operations. An agent skill from dkyazzentwatwa/apple-flow.

    105 GitHub stars~718 tokensUpdated 6 mo ago
    Auto-check passed
  • Apple Flow Ops

    dkyazzentwatwa/apple-flow

    A skill your agent uses when working on Apple Flow in the apple-flow repository.

    105 GitHub stars~1k tokensUpdated 6 mo ago
    Auto-check: notes
  • Apple Flow Pages

    dkyazzentwatwa/apple-flow

    Universal Markdown-to-Apple-Pages formatting skill for Apple Flow.

    105 GitHub stars~1k tokensUpdated 6 mo ago
    Auto-check passed
  • Apple Flow Gateways

    dkyazzentwatwa/apple-flow

    Core routing and troubleshooting skill for Apple Flow gateways (Mail, Reminders, Notes, Calendar).

    105 GitHub stars~766 tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Apple Flow Numbers

What does Apple Flow Numbers do?

General Apple Numbers automation for Apple Flow. An agent skill from dkyazzentwatwa/apple-flow. Apple Flow Numbers is an agent skill from dkyazzentwatwa/apple-flow. General Apple Numbers automation for Apple Flow.

When should I use Apple Flow Numbers?

Apple Flow Numbers fits situations like: working with .numbers files through apple-flow tools; including creating new sheets; appending structured rows; choosing insertion behavior (after-data.

How do I install Apple Flow Numbers in Claude Code?

Run `npx skills add dkyazzentwatwa/apple-flow --skill apple-flow-numbers -a claude-code`. Or copy the skill folder (skills/apple-flow-numbers in dkyazzentwatwa/apple-flow) into .claude/skills/apple-flow-numbers in your project. Claude Code loads it when a task matches its description.

How do I install Apple Flow Numbers in Codex?

Run `npx skills add dkyazzentwatwa/apple-flow --skill apple-flow-numbers -a codex`. Or copy the skill folder (skills/apple-flow-numbers in dkyazzentwatwa/apple-flow) into .agents/skills/apple-flow-numbers in your project. Codex loads it when a task matches its description.

Can I use Apple Flow Numbers in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dkyazzentwatwa/apple-flow --skill apple-flow-numbers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-flow-numbers, .gemini/skills/apple-flow-numbers, .github/skills/apple-flow-numbers and .opencode/skills/apple-flow-numbers in your project.

What does Apple Flow Numbers need to run?

Going by SKILL.md and its folder, Apple Flow Numbers needs the command-line tools its instructions call (osascript).

Does Apple Flow Numbers access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Apple Flow Numbers safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apple Flow Numbers use?

Apple Flow Numbers is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Flow Numbers use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Flow Numbers?

Skills that share tags, products or a category with Apple Flow Numbers: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Flow Numbers?

dkyazzentwatwa (a GitHub user) maintains it in dkyazzentwatwa/apple-flow, which has 105 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on March 30, 2026.

Source: dkyazzentwatwa/apple-flow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.