โ† All skills
Tencent SkillHub ยท Productivity

Opys Calendar Skill

A local markdown-backed calendar with CLI and optional two-way Google Calendar sync.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

A local markdown-backed calendar with CLI and optional two-way Google Calendar sync.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
.calendar-google-sync-state.json, .calendar-settings.json, .tmp-recent-calendar.md, README.md, SKILL.md, calendar.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
0.1.2

Documentation

ClawHub primary doc Primary doc: SKILL.md 11 sections Open source page

Calendar Markdown + Google Sync Skill

Use this skill to query/update the local markdown-backed calendar safely and sync it with Google Calendar.

Source of Truth

File: calendar.md Authoritative section: ## Event Records (fenced event YAML blocks) Human summary section: ## Event Checklist

Event Identity Rules

id: local identifier externalId: stable cross-system identifier used for dedupe googleEventIds: per-calendar Google event mapping updatedAt: event-level timestamp for conflict resolution Do not remove externalId from existing records.

Preferred Interface

Use CLI from repo root: npm run cli -- <command>

Safe Query Flow

Run npm run cli -- summary. If raw markdown is needed, run npm run cli -- export.

Safe Update Flow

Add (preferred for new events): npm run cli -- add --title "..." --start "<ISO>" --end "<ISO>" --category <id> [--shift-to-next|--allow-overlap] Update: npm run cli -- update --id <event_id> [fields...] If changing --start or --end, include --shift-to-next or --allow-overlap in non-interactive runs. Check/uncheck: npm run cli -- check --id <event_id> or --undone Delete: npm run cli -- delete --id <event_id> Add category: npm run cli -- category-add --id <id> --label "Label" --color "#9ca3af" --description "..." Remove category: npm run cli -- category-remove --id <id> --reassign <id> Conflict handling: add and time-changing update detect overlaps with existing events. Interactive runs can choose accept overlap, shift to next available slot, or provide a custom time. Non-interactive runs: --shift-to-next to auto-resolve to the next open window. --allow-overlap to keep the requested overlapping time. Agent snapshot output: Every mutating CLI command writes a rolling markdown snapshot. Default path: ./agent-snapshot.md Override with CALENDAR_AGENT_SNAPSHOT. Recent window defaults to 14 days and is configurable with CALENDAR_AGENT_DAYS. Snapshot also includes upcoming 7 days when events exist.

UI Constraints

UI does not provide add-event form/button. Events are created via CLI agents only. UI still supports drag/drop, resize, and check-off.

Google Sync Flow

In UI, sign in with Google. Select target calendar via calendar selector controls. Click Sync Now for two-way merge. Sync state file: .calendar-google-sync-state.json

Import/Export

Export: npm run cli -- export --out backup-calendar.md Import: npm run cli -- import --in backup-calendar.md

Notes for Agents

Keep datetimes in ISO format. Prefer CLI operations over manual markdown edits. If categories are changed manually in frontmatter, keep id, label, and color fields valid.

Environment Variables

This skill uses the following environment variables (defined in .env): Google Calendar Sync (Optional) GOOGLE_CLIENT_ID: Google OAuth Client ID GOOGLE_CLIENT_SECRET: Google OAuth Client Secret GOOGLE_REDIRECT_URI: Should be http://localhost:<PORT>/api/google/auth/callback Agent Configuration (Optional) CALENDAR_AGENT_SNAPSHOT: Custom absolute or relative path to write the Markdown snapshot. Defaults to ./agent-snapshot.md. CALENDAR_AGENT_DAYS: Number of historical days to include in the snapshot (defaults to 14). PORT: API server port (defaults to 8787). APP_BASE_URL: Base URL for the frontend UI.

Category context

Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
4 Docs2 Config
  • SKILL.md Primary doc
  • .tmp-recent-calendar.md Docs
  • calendar.md Docs
  • README.md Docs
  • .calendar-google-sync-state.json Config
  • .calendar-settings.json Config