← Back to Skills Marketplace
goog

cal-candy: a Markdown calendar

by Jay · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
160
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install cal-candy
Description
Manage local markdown-based calendar: add, list, view monthly, check today/upcoming events, set reminders, and delete events efficiently.
README (SKILL.md)

Cal-Candy - Markdown Calendar

基于本地 Markdown 文件的日历系统，事件默认存储在 ~/.openclaw/workspace/calendar/ 目录, user can set the location by env MDCAL_DIR。

快速开始

所有命令通过 python scripts/mdcal.py \x3Ccommand> 执行：

添加事件

python scripts/mdcal.py add \x3Cdate> \x3Ctime> \x3Ctitle> [desc] [-r minutes]
  • date: 日期 (YYYY-MM-DD) 或 today/tomorrow
  • time: 时间 (HH:MM)
  • title: 事件标题
  • desc: 可选描述
  • -r: 可选提醒（提前分钟数）

示例:

python scripts/mdcal.py add today 14:00 团队会议 :: 讨论项目进度 -r 15
python scripts/mdcal.py add 2026-04-01 10:00 "openclaw meeting"

查看事件

python scripts/mdcal.py list [month] [-a]
  • month: 月份 (YYYY-MM 或 MM)，默认当月
  • -a: 显示所有事件包括过去的

示例:

python scripts/mdcal.py list          # 当月事件
python scripts/mdcal.py list -a       # 显示所有
python scripts/mdcal.py list 2026-03  # 指定月

日历视图

python scripts/mdcal.py view [year] [month]

以日历格式显示本月或指定月份。

今日事件

python scripts/mdcal.py today

即将到来

python scripts/mdcal.py upcoming [-d days]

默认显示未来7天事件。

设置提醒

python scripts/mdcal.py remind [event_id] [minutes]

查看或设置事件提醒。

删除事件

python scripts/mdcal.py delete \x3Cevent_id>

事件ID为5位UUID，列出会显示在事件后面。

数据存储

  • 日历文件: ~/.openclaw/workspace/calendar/YYYY-MM.md
  • 提醒文件: ~/.openclaw/workspace/calendar/reminders.json

事件格式：

- [ ] 2026-03-22 14:00 会议标题 :: 描述 #abc12

常用场景

  1. 查看今天有啥安排: python scripts/mdcal.py today
  2. 查看本月日程: python scripts/mdcal.py list
  3. 添加会议: python scripts/mdcal.py add tomorrow 15:00 会议 :: 讨论Q1目标 -r 10
  4. 添加提醒: python scripts/mdcal.py remind \x3Cevent_id> 15
Usage Guidance
This skill appears to do what it says: it stores calendar entries and reminders as files under ~/.openclaw/workspace/calendar (or MDCAL_DIR if set). Before installing, consider: (1) the repository/source is listed as unknown and no homepage is provided — if provenance matters, verify the author or inspect the included scripts (you already have them); (2) it requires Python and the 'rich' package but does not declare dependencies — install those in your environment or a virtualenv; (3) the script writes files to your home directory (calendar Markdown files and reminders.json), so back them up or choose a custom MDCAL_DIR if you want them elsewhere; (4) event IDs are only the first 5 characters of a UUID (higher collision risk) — avoid relying on IDs for critical automation. If you want extra caution, run the script in a sandboxed environment or review/modify the code to suit your security/privacy policies.
Capability Analysis
Type: OpenClaw Skill Name: cal-candy Version: 1.0.1 The cal-candy skill is a legitimate local calendar management tool that stores events in Markdown files and reminders in a JSON file within a dedicated workspace directory (~/.openclaw/workspace/calendar/). The Python script (scripts/mdcal.py) implements standard calendar functionality such as adding, listing, viewing, and deleting events without any high-risk behaviors like network access, shell execution, or sensitive data exfiltration.
Capability Assessment
✓ Purpose & Capability
Name/description match the implementation: the script implements add, list, view, today, upcoming, remind, and delete operations against Markdown files in a per-user calendar directory. The optional MDCAL_DIR environment variable is used as documented.
✓ Instruction Scope
SKILL.md instructs the agent to run `python scripts/mdcal.py <command>`. The runtime actions are limited to creating/reading/writing ~/.openclaw/workspace/calendar/*.md and reminders.json. There are no instructions to read unrelated files, contact external services, or gather secrets.
ℹ Install Mechanism
No install spec is provided (instruction-only), which keeps risk low. However, the script imports the third-party 'rich' Python package but the SKILL.md does not declare Python version or dependencies; the environment must have Python and the 'rich' package installed or the script will fail. No network downloads or external installers are present.
✓ Credentials
The skill requests no credentials and uses a single optional env var (MDCAL_DIR) to override the calendar location, which is proportionate to its function. It does write files under the user's home directory as expected.
✓ Persistence & Privilege
The skill is not always-enabled and can be invoked by the user. It does not modify other skills or global agent settings. Its persistent artifacts are calendar Markdown files and reminders.json in the user's workspace directory.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cal-candy
  3. After installation, invoke the skill by name or use /cal-candy
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added support for configuring the calendar storage directory via the MDCAL_DIR environment variable. - Clarified default storage location and updated documentation to reflect configurable data directory. - Improved documentation examples for adding events with quoted titles.
v1.0.0
Initial release of cal-candy: a local, markdown-based calendar for event and reminder management. - Add calendar events with date, time, title, and optional description. - List upcoming or past events, including monthly and "today" views. - View events as a markdown calendar. - Set and manage reminders for events. - Delete events by unique ID. - All data stored locally in markdown and json files for privacy and simplicity.
Metadata
Slug cal-candy
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is cal-candy: a Markdown calendar?

Manage local markdown-based calendar: add, list, view monthly, check today/upcoming events, set reminders, and delete events efficiently. It is an AI Agent Skill for Claude Code / OpenClaw, with 160 downloads so far.

How do I install cal-candy: a Markdown calendar?

Run "/install cal-candy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is cal-candy: a Markdown calendar free?

Yes, cal-candy: a Markdown calendar is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does cal-candy: a Markdown calendar support?

cal-candy: a Markdown calendar is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created cal-candy: a Markdown calendar?

It is built and maintained by Jay (@goog); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments