Agent skill

Fantastical Calendar

by twhsi in twhsi/skills

Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.

No licenceAuto-check passedProductivity & Automation

Install Fantastical Calendar

skills CLI
$ npx skills add twhsi/skills --skill fantastical-calendar -a claude-code

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

GitHub CLI
$ gh skill install twhsi/skills fantastical-calendar --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/twhsi/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fantastical-calendar .claude/skills/fantastical-calendar && 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
fantastical-calendar
GitHub stars
259
Token cost
~688 tokens
SKILL.md length
297 words
Files
4 (incl. scripts, references)
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.

  • Works in 6 steps: Clarify only when a calendar detail is… → Convert relative dates into explicit… → Build one concise Fantastical sentence… → …
  • Adding a meeting or appointment to Fantastical from a chat request
  • SKILL.md covers Overview, Workflow, Add Policy and Sentence Patterns, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

The agent converts a natural-language request into one concise Fantastical sentence with the title, an exact date, a start time and a duration or end time, then passes it to `scripts/fantastical_parse.py`. Relative dates are turned into explicit dates first, using the user's timezone, and extra context such as links or prep notes goes into a `--notes` option rather than the title. It asks questions only when something like the date, time, calendar or event-versus-reminder choice is genuinely ambiguous.

The script defaults to preview mode, which opens Fantastical with the parsed item without adding it. An item is added right away, with `--add-immediately`, only when you explicitly ask to add or schedule it or have confirmed the parsed result, and `--dry-run` validates without opening anything. The script tries AppleScript `parse sentence` first and can fall back to the Fantastical URL scheme. Replies to Chinese requests stay in Chinese, and a reference file on the macOS integration is read only when debugging or adapting the script.

When your agent uses it

  • Adding a meeting or appointment to Fantastical from a chat request
  • Setting a reminder or task for a specific date and time
  • Blocking focus time as part of a daily plan
  • Previewing a parsed event before it is saved

Example prompts

  • “Schedule Project review on 2026-06-19 at 10:00 and put the prep deck reminder in the notes.”
  • “Remind me to submit expenses on 2026-06-21 at 09:00.”
  • “Preview a focus block on 2026-06-18 from 14:00 to 16:00 without saving it.”

Requirements

  • macOS with the Fantastical app installed
  • Python 3 to run `scripts/fantastical_parse.py`

Workflow steps

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

  1. Clarify only when a calendar detail is genuinely ambiguous: date, time, duration, title, attendee context, calendar, or whether it is an…
  2. Convert relative dates into explicit dates before sending to Fantastical whenever possible. Use the user's current timezone from the…
  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 287d0f4. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Fantastical Calendar loads about 688 tokens when it runs, and up to ~1k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 297 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~688
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 297 words (~688 tokens).

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

— opening of SKILL.md by twhsi
name
fantastical-calendar

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts, references) in skills/fantastical-calendar of twhsi/skills.

  • SKILL.md
  • agents/openai.yaml
  • references/fantastical-macos.md
  • scripts/fantastical_parse.py

Open the folder on GitHubat commit 287d0f4

Compare with similar skills

Fantastical Calendar 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.

Fantastical Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fantastical Calendar this skilltwhsi/skills259—~688Automated safety check: PassNone
Topydosundial-org/awesome-openclaw-skills663—~1.7kAutomated safety check: NotesMIT
Disk Storage AnalyzerKKKKhazix/khazix-skills21k1 repos~1.4kAutomated safety check: PassMIT
Prismer Google WorkspacePrismer-AI/PrismerCloud1.6k3 repos~4.2kAutomated safety check: PassMIT
Jev Desktop Computer Usekerpopule/hermes-jev-skills1.1k—~4.3kAutomated safety check: PassMIT
Kanban TuiZaloog/kanban-tui285—~4.1kAutomated safety check: PassMIT

Similar skills

  • Topydo

    sundial-org/awesome-openclaw-skills

    Manage todo.txt tasks using topydo CLI. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~1.7k tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check: notes
  • Disk Storage Analyzer

    KKKKhazix/khazix-skills

    Scans a Mac or Windows PC read-only to find what fills the disk, grades each item by how safe it is to clean and builds an interactive HTML report.

    21k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • Prismer Google Workspace

    Prismer-AI/PrismerCloud

    Gives an agent account-scoped access to Gmail, Calendar, Drive, Contacts, Docs and Sheets through the gws CLI or a bundled Python client.

    1.6k GitHub starsUsed in 3 repos~4.2k tokens
    Productivity & AutomationAuto-check passed
  • Jev Desktop Computer Use

    kerpopule/hermes-jev-skills

    Drives desktop GUI apps and OS dialogs by letting Jev pick the next action from a menu of safe actions the agent built, with a Mac Co-Agent shortcut.

    1.1k GitHub stars~4.3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Kanban Tui

    Zaloog/kanban-tui

    Comprehensive kanban board and task management via ktui CLI.

    285 GitHub stars~4.1k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Todo List CSV

    lili-luo/aicoding-cookbook

    当需要修改项目(增删改文件)并希望将 updateplan 与 CSV 有机同步时使用此技能:在项目根目录创建“{任务名} TO DO list.csv”,用 TODO/INPROGRESS/DONE 驱动 plan 的 pending/inprogress/completed,同步推进,全部完成后删除该文件。

    687 GitHub stars~682 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check passed

More from twhsi/skills

All 18 skills in this repo
  • Compiles notes, outlines, PDFs or BIRD and iMandalArt content into an eight-page mini book, with upright page PDFs, a reading PDF, an editable DOCX and an A4 landscape print sheet.

    259 GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.

    259 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Turns source material into a pure-text 3x3 iMandalArt 2.2 card with a five-character center and eight labeled surrounding angles, laid out with hard line breaks.

    259 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check passed
  • Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links.

    259 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Todays Daily Plan

    twhsi/skills

    Write spoken daily planning notes into an Obsidian Mandala Grid day-plan Markdown file.

    259 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip.

    259 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Fantastical Calendar

What does Fantastical Calendar do?

Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm. py`. Relative dates are turned into explicit dates first, using the user's timezone, and extra context such as links or prep notes goes into a `--notes` option rather than the title.

When should I use Fantastical Calendar?

Fantastical Calendar fits situations like: adding a meeting or appointment to Fantastical from a chat request; setting a reminder or task for a specific date and time; blocking focus time as part of a daily plan; previewing a parsed event before it is saved.

How do I install Fantastical Calendar in Claude Code?

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

How do I install Fantastical Calendar in Codex?

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

Can I use Fantastical Calendar 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 twhsi/skills --skill fantastical-calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fantastical-calendar, .gemini/skills/fantastical-calendar, .github/skills/fantastical-calendar and .opencode/skills/fantastical-calendar in your project.

What does Fantastical Calendar need to run?

Going by SKILL.md and its folder, Fantastical Calendar needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: macOS with the Fantastical app installed; Python 3 to run `scripts/fantastical_parse.py`.

Does Fantastical Calendar 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 Fantastical Calendar 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Fantastical Calendar use?

No licence was found for Fantastical Calendar or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Fantastical Calendar use?

About 688 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 346 tokens, read only when the agent opens those files.

What are the alternatives to Fantastical Calendar?

Skills that share tags, products or a category with Fantastical Calendar: Topydo (sundial-org/awesome-openclaw-skills, 663 stars), Disk Storage Analyzer (KKKKhazix/khazix-skills, 21k stars), Prismer Google Workspace (Prismer-AI/PrismerCloud, 1.6k stars) and Jev Desktop Computer Use (kerpopule/hermes-jev-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fantastical Calendar?

twhsi (a GitHub user) maintains it in twhsi/skills, which has 259 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 21, 2026.

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