Skip to content
Productivity
Skill

/fantastical-calendar

Create Fantastical calendar events and reminders from Codex on macOS. Use when the user asks Codex to add, schedule, parse, preview, or send a meeting, appointment, task, reminder, time block, daily plan item, 行事曆, 日曆, 會議, 待辦, or 提醒 into Fantastical.

From plugin
skills
25918 skills

Claude Code

$ npx -y skills add twhsi/skills --skill fantastical-calendar --agent claude-code

SKILL.md

fantastical-calendar.SKILL.md
name: fantastical-calendar
description: Create Fantastical calendar events and reminders from Codex on macOS. Use when the user asks Codex to add, schedule, parse, preview, or send a meeting, appointment, task, reminder, time block, daily plan item, 行事曆, 日曆, 會議, 待辦, or 提醒 into Fantastical.

Fantastical Calendar

Overview

Use this skill to turn a user's natural-language scheduling request into a Fantastical event or reminder through the local macOS Fantastical app.

Prefer the bundled script over ad hoc AppleScript:

python3 scripts/fantastical_parse.py "Project review on 2026-06-19 at 10:00" --notes "Prep deck before the call"

The script defaults to preview mode: it opens Fantastical with the parsed item but does not add it immediately.

Workflow

1. Clarify only when a calendar detail is genuinely ambiguous: date, time, duration, title, attendee context, calendar, or whether it is an event vs reminder. 2. Convert relative dates into explicit dates before sending to Fantastical whenever possible. Use the user's current timezone from the thread context or check the system date if needed. 3. Build one concise Fantastical sentence containing the title, exact date, start time, and duration or end time. 4. Put extra context, links, preparation notes, or source text in `--notes` instead of overloading the event title. 5. Run `scripts/fantastical_parse.py` from this skill folder. 6. Tell the user whether Fantastical was opened for review or the item was added immediately.

Add Policy

Use preview mode unless the user explicitly asks to add/create/schedule it now or has confirmed the parsed result.

Preview:

python3 scripts/fantastical_parse.py "Deep work on 2026-06-19 from 09:00 to 11:00"

Add immediately:

python3 scripts/fantastical_parse.py "Deep work on 2026-06-19 from 09:00 to 11:00" --add-immediately

Dry run for validation:

python3 scripts/fantastical_parse.py "Deep work on 2026-06-19 from 09:00 to 11:00" --dry-run

Sentence Patterns

Use explicit, Fantastical-friendly wording:

  • `Team sync on 2026-06-19 from 10:00 to 10:30`
  • `Call Alice on 2026-06-20 at 15:00 for 45 minutes`
  • `Remind me to submit expenses on 2026-06-21 at 09:00`
  • `Focus block on 2026-06-18 from 14:00 to 16:00`

For Chinese user requests, keep the user-facing reply in Chinese, but send Fantastical an explicit mixed or English sentence if it reduces parsing risk.

Local Integration Details

Read `references/fantastical-macos.md` only when debugging the app integration, updating the script, or adapting it to another Fantastical version.

The current script uses AppleScript `parse sentence` first and can fall back to the Fantastical URL scheme when needed.

Read more
@twhsi
Ships withskills

Three Kings 2.2: compress with iMandalArt, address with BIRD, and publish with an A4 eight-page booklet. iMandalArt, FIRE semantic analysis, planning, and publishing workflows for Claude Code, Codex, and mainstream LLM agents.

Stars on GitHub

Momentum

stars in total
259
Star history of twhsi/skills on GitHub, a chart by star-history.com

Other skills on skills.

a4-eight-page-booklet

a4-eight-page-booklet

Use A4 Eight Page Booklet 2.2 to create, write, repair, impose, and validate a printable A4 one-sheet eight-page mini book or…

@twhsi@twhsiInstall Skill
auto-luhmann-numberer

auto-luhmann-numberer

Assign, validate, normalize, and explain Luhmann/Zettelkasten-style project-note codes for Chinese book manuscripts, Obsidian…

@twhsi@twhsiInstall Skill
concise-key-points

concise-key-points

Compress answers to the highest practical information density with minimal wording while preserving essential meaning. Use when…

@twhsi@twhsiInstall Skill
epub-hypercard-obsidian

epub-hypercard-obsidia…

Convert EPUB card books into Obsidian-ready HyperCard Markdown folders and portable zip files. Use when Codex needs to turn an…

@twhsi@twhsiInstall Skill
fire-analysis-card

fire-analysis-card

Analyze Chinese notes, articles, manuscripts, and digital card-box material with FIRE 2.0: Full-D numbering, Index keyword webs,…

@twhsi@twhsiInstall Skill
fire-card-to-epub

fire-card-to-epub

Convert FIRE analysis cards, Chinese knowledge notes, or project-note JSON into validated EPUB books with directory cards,…

@twhsi@twhsiInstall Skill

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about fantastical-calendar.

Which coding agents can use fantastical-calendar?
fantastical-calendar installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.