dkyazzentwatwa/apple-flow/apple-flow-pages

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):

apple-flow tools pages_from_markdown \
  "/abs/path/proposal.md"

1. Convert to explicit destination:

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:

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):

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:

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:

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:

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

1. Pipe markdown via stdin to pages_from_markdown (or save .md then convert).
2. 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).