Agent skill

Calctl

by CraftOS-dev in CraftOS-dev/CraftBot

Manage Apple Calendar events via icalBuddy + AppleScript CLI

MITAuto-check passed

Install Calctl

skills CLI
$ npx skills add CraftOS-dev/CraftBot --skill calctl -a claude-code

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

GitHub CLI
$ gh skill install CraftOS-dev/CraftBot calctl --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/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/calctl .claude/skills/calctl && 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
calctl
GitHub stars
392
Used in
2 other repos
Token cost
~454 tokens
SKILL.md length
120 words
Files
2
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Manage Apple Calendar events via icalBuddy + AppleScript CLI

  • SKILL.md covers Commands, Examples, Options for add and Available Calendars
  • Calls brew

What it does

Calctl is an agent skill from CraftOS-dev/CraftBot. Manage Apple Calendar events via icalBuddy + AppleScript CLI

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `_meta.json`).

The repository describes itself as: One agent. Every kind of work. The licence is MIT.

Example prompts

  • “/calctl”

What it can do on your machine

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

    • brew

    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

Calctl loads about 454 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 120 words of instructions outside code blocks.

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

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 CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 120 words, ~454 tokens.

Download SKILL.mdSave it as .claude/skills/calctl/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
calctl
description
Manage Apple Calendar events via icalBuddy + AppleScript CLI

calctl - Apple Calendar CLI

Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).

Requirements: brew install ical-buddy

Commands

CommandDescription
calctl calendarsList all calendars
calctl show [filter]Show events (today, tomorrow, week, YYYY-MM-DD)
calctl add <title>Create a new event
calctl search <query>Search events by title (next 30 days)

Examples

bash
# List calendars
calctl calendars

# Show today's events
calctl show today

# Show this week's events
calctl show week

# Show events from specific calendar
calctl show week --calendar Work

# Show events on specific date
calctl show 2026-01-25

# Add an event
calctl add "Meeting with John" --date 2026-01-22 --time 14:00

# Add event to specific calendar
calctl add "Team Standup" --calendar Work --date 2026-01-22 --time 09:00 --end 09:30

# Add all-day event
calctl add "Holiday" --date 2026-01-25 --all-day

# Add event with notes
calctl add "Project Review" --date 2026-01-22 --time 15:00 --notes "Bring quarterly report"

# Search for events
calctl search "meeting"

Options for add

OptionDescriptionDefault
-c, --calendar <name>Calendar to add event toPrivat
-d, --date <YYYY-MM-DD>Event datetoday
-t, --time <HH:MM>Start time09:00
-e, --end <HH:MM>End time1 hour after start
-n, --notes <text>Event notesnone
--all-dayCreate all-day eventfalse

Available Calendars

Common calendars on this system:

  • Privat (personal)
  • Work
  • Familien Kalender
  • rainbat solutions GmbH
  • TimeTrack

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

Files

SKILL.md and 1 other file in skills/calctl of CraftOS-dev/CraftBot.

  • SKILL.md
  • _meta.json

Open the folder on GitHubat commit b50970c

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in CraftOS-dev/CraftBot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Calctl 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.

Calctl compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Calctl this skillCraftOS-dev/CraftBot3922 repos~454Automated safety check: PassMIT
Google Calendarcodewhale-hq/Codewhale41k—~512Automated safety check: PassMIT
Calendar Event Creatorjeremylongshore/tons-of-skills-marketplace2.8k—~584Automated safety check: PassMIT
Apple Calendarhashgraph-online/awesome-codex-plugins1.2k—~1.2kAutomated safety check: PassApache-2.0
Eventscoreyhaines31/marketingskills54k—~3kAutomated safety check: PassMIT
Apple Notes Webhooks Eventsjeremylongshore/tons-of-skills-marketplace2.8k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Google Calendar

    codewhale-hq/Codewhale

    Reads schedules, checks free and busy time, and creates or updates Google Calendar events through the Calendar API, with care around invites and recurring series.

    41k GitHub stars~512 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Calendar Event Creator

    jeremylongshore/tons-of-skills-marketplace

    Create calendar event creator operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~584 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Apple Calendar

    hashgraph-online/awesome-codex-plugins

    Read and create Calendar.app events through a local macOS helper.

    1.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Events

    coreyhaines31/marketingskills

    When the user wants to plan, run, sponsor, speak at, or get pipeline from events — webinars, conferences, trade shows, meetups, dinners, workshops, virtual summits, or user conferences.

    54k GitHub stars~3k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Apple Notes Webhooks Events

    jeremylongshore/tons-of-skills-marketplace

    Monitor Apple Notes changes using file system events and Shortcuts triggers.

    2.8k GitHub stars~1.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • Skill Event Calendar

    ZJU-REAL/Easel

    查询未来 N 天的节日、纪念日、电商节点、行业事件,为创作者提供内容蹭点. An agent skill from ZJU-REAL/Easel.

    3.2k GitHub stars~893 tokensUpdated today
    Writing & ContentAuto-check passed

More from CraftOS-dev/CraftBot

All 89 skills in this repo
  • Self Improvement

    CraftOS-dev/CraftBot

    Captures learnings, errors, and corrections to enable continuous improvement.

    392 GitHub starsUsed in 5 repos~4.9k tokens
    Auto-check passed
  • Bbc News

    CraftOS-dev/CraftBot

    Fetch and display BBC News stories from various sections and regions via RSS feeds.

    392 GitHub starsUsed in 2 repos~555 tokens
    Auto-check passed
  • Outlook

    CraftOS-dev/CraftBot

    Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

    392 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Nano Banana Pro

    CraftOS-dev/CraftBot

    Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image).

    392 GitHub starsUsed in 6 repos~1.4k tokens
    Auto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Telegram Bot Manager

    CraftOS-dev/CraftBot

    Manage and configure Telegram bots for OpenClaw. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~836 tokensUpdated today
    Auto-check passed

Questions about Calctl

What does Calctl do?

Manage Apple Calendar events via icalBuddy + AppleScript CLI. Calctl is an agent skill from CraftOS-dev/CraftBot.

How do I install Calctl in Claude Code?

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

How do I install Calctl in Codex?

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

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

What does Calctl need to run?

Going by SKILL.md and its folder, Calctl needs the command-line tools its instructions call (brew).

Does Calctl 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 Calctl 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 Calctl use?

Calctl 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 Calctl use?

About 454 tokens (SKILL.md is roughly 1.8k 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 Calctl?

Skills that share tags, products or a category with Calctl: Google Calendar (codewhale-hq/Codewhale, 41k stars), Calendar Event Creator (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Apple Calendar (hashgraph-online/awesome-codex-plugins, 1.2k stars) and Events (coreyhaines31/marketingskills, 54k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Calctl?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

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