Agent skill

Apple Flow Pages

by dkyazzentwatwa in dkyazzentwatwa/apple-flow

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

MITAuto-check passedDocuments & Office

Install Apple Flow Pages

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

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

GitHub CLI
$ gh skill install dkyazzentwatwa/apple-flow apple-flow-pages --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-pages .claude/skills/apple-flow-pages && 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-pages
GitHub stars
105
Token cost
~1k tokens
SKILL.md length
317 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 7 steps: Convert markdown using default output… → Convert to explicit destination → Use neutral style → …
  • Converting .md files into polished .pages documents with accurate structure (headings
  • SKILL.md covers Quick Start, Research-to-Report Workflow, Supported Markdown and Input / Output Rules, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Apple Flow Pages is an agent skill from dkyazzentwatwa/apple-flow. Universal Markdown-to-Apple-Pages formatting skill for Apple Flow. Use when converting .md files into polished .pages documents with accurate structure (headings, lists, tables, code blocks, links) and clean business-ready styling.

Its SKILL.md is about 1k 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 Documents & Office, covering Markdown. The repository describes itself as: Your Apple-Native AI Agent. The licence is MIT.

When your agent uses it

  • Converting .md files into polished .pages documents with accurate structure (headings
  • Links) and clean business-ready styling

Example prompts

  • “/apple-flow-pages”

Workflow steps

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

  1. Convert markdown using default output path (same-name.pages)
  2. Convert to explicit destination
  3. Use neutral style
  4. On-the-fly generation (no pre-existing markdown file)
  5. Render with deterministic QA + exports
  6. Merge only selected sections and render
  7. Create a starter template

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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 Pages loads about 1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 317 words of instructions outside code blocks.

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

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). 317 words, ~1,040 tokens.

Download SKILL.mdSave it as .claude/skills/apple-flow-pages/SKILL.md (or your agent's skills folder).
name
apple-flow-pages
description
Universal Markdown-to-Apple-Pages formatting skill for Apple Flow. Use when converting `.md` files into polished `.pages` documents with accurate structure (headings, lists, tables, code blocks, links) and clean business-ready styling.

Apple Flow Pages

Use this skill to turn markdown into polished Apple Pages documents quickly.

Primary command:

  • apple-flow tools pages_from_markdown <input.md|-> [output.pages] [--theme auto|neutral|minimal|corporate|legal|proposal] [--style auto|neutral] [--title-page auto|off] [--toc auto|off] [--citations auto|off] [--images auto|off] [--image-max-width N] [--page-break-marker TEXT] [--qa true|false] [--export none|pdf|docx|pdf,docx] [--overwrite true|false]

Related commands:

  • apple-flow tools pages_update_sections <base.md|-> <updates.md> <output.pages> [--sections "A,B"] [same render flags]
  • apple-flow tools pages_template <research|contract|proposal> [output.md] [--overwrite true|false]

Quick Start

  1. Convert markdown using default output path (same-name.pages):
bash
apple-flow tools pages_from_markdown \
  "/abs/path/proposal.md"
  1. Convert to explicit destination:
bash
apple-flow tools pages_from_markdown \
  "/abs/path/contract.md" \
  "/abs/path/client-contract.pages" \
  --theme legal \
  --title-page on \
  --toc on \
  --overwrite true
  1. Use neutral style:
bash
apple-flow tools pages_from_markdown \
  "/abs/path/notes.md" \
  "/abs/path/notes.pages" \
  --style neutral \
  --overwrite true
  1. On-the-fly generation (no pre-existing markdown file):
bash
cat <<'MD' | apple-flow tools pages_from_markdown - "/abs/path/ai-agent-systems.pages" --style auto --overwrite true
# AI Agent Systems Report

## Executive Summary
...

## Landscape
...
MD
  1. Render with deterministic QA + exports:
bash
apple-flow tools pages_from_markdown \
  "/abs/path/research.md" \
  "/abs/path/research.pages" \
  --theme corporate \
  --toc on \
  --citations on \
  --qa true \
  --export pdf,docx \
  --overwrite true
  1. Merge only selected sections and render:
bash
apple-flow tools pages_update_sections \
  "/abs/path/base-proposal.md" \
  "/abs/path/updates.md" \
  "/abs/path/final-proposal.pages" \
  --sections "Executive Summary,Timeline,Risks" \
  --theme proposal \
  --overwrite true
  1. Create a starter template:
bash
apple-flow tools pages_template proposal "/abs/path/proposal-template.md"

Research-to-Report Workflow

When user asks:

  • "Do research on the web for AI agent systems and make a beautiful Pages report"

Use this sequence:

  1. Perform web research first (collect sources, key findings, comparisons).
  2. Draft a structured markdown report:
    • title
    • executive summary
    • findings
    • comparison table
    • recommendations
  3. Pipe markdown via stdin to pages_from_markdown (or save .md then convert).
  4. Return final .pages path plus short summary.

Supported Markdown

  • Headings (#, ##, ###)
  • Paragraphs
  • Unordered and ordered lists
  • Horizontal rules (---, ***, ___)
  • Inline formatting: bold, italic, code, links
  • Fenced code blocks
  • Markdown tables

Input / Output Rules

  • Input file must exist and be UTF-8 text.
  • Input can be - to read markdown from stdin.
  • Output must end with .pages.
  • If output path is omitted, default is <input_basename>.pages in the same directory.
  • Existing output is blocked unless --overwrite true.
  • pages_template outputs .md files (not .pages).

Troubleshooting

  • input file not found:
    • Confirm absolute path and file name.
  • output exists and overwrite=false:
    • Re-run with --overwrite true or choose another output path.
  • Application isn’t running / AppleScript errors:
    • Launch Pages once manually and grant Automation permissions, then retry.
  • textutil conversion failed:
    • Confirm macOS textutil availability and source markdown readability.

Done Criteria

  • Command returns "ok": true.
  • output_path points to a real .pages file.
  • Result stats look sensible (headings/lists/tables/code counts align with source markdown).

© 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-pages of dkyazzentwatwa/apple-flow.

Open the folder on GitHubat commit 4b9cf4f

Compare with similar skills

Apple Flow Pages 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 Pages compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Flow Pages this skilldkyazzentwatwa/apple-flow105—~1kAutomated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Crosspostingwasp-lang/wasp19k—~1.1kAutomated safety check: PassMIT
Gzh Designisjiamu/gzh-design-skill4k—~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    4k GitHub stars~2.2k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Review The Docs

    supabase/supabase

    Official

    Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).

    111k GitHub stars~4.6k tokensUpdated yesterday
    Documents & OfficeAuto-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 Numbers

    dkyazzentwatwa/apple-flow

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

    105 GitHub stars~1.5k 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 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

Questions about Apple Flow Pages

What does Apple Flow Pages do?

Universal Markdown-to-Apple-Pages formatting skill for Apple Flow. Apple Flow Pages is an agent skill from dkyazzentwatwa/apple-flow. Universal Markdown-to-Apple-Pages formatting skill for Apple Flow.

When should I use Apple Flow Pages?

Apple Flow Pages fits situations like: converting .md files into polished .pages documents with accurate structure (headings; links) and clean business-ready styling.

How do I install Apple Flow Pages in Claude Code?

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

How do I install Apple Flow Pages in Codex?

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

Can I use Apple Flow Pages 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-pages -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-pages, .gemini/skills/apple-flow-pages, .github/skills/apple-flow-pages and .opencode/skills/apple-flow-pages in your project.

What does Apple Flow Pages need to run?

SKILL.md names no scripts, command-line tools or credentials: Apple Flow Pages is instructions for the agent only.

Does Apple Flow Pages 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 Pages 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 Pages use?

Apple Flow Pages 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 Pages use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Pages?

Skills that share tags, products or a category with Apple Flow Pages: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Crossposting (wasp-lang/wasp, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Flow Pages?

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.