xs-calendar

xs-calendar is a skill for Claude Code, Codex from karaage0703/ai-assistant-workspace. It costs 67 tokens per session (842 once invoked), scanned A, original, MIT.

A calendar tool that combines events from ICS feeds, a standard calendar-file format used by services such as Google Calendar, with manually added events. It can also read dates and times from a calendar screenshot.

In plain words
What is it for?
Use it to view today’s, tomorrow’s, weekly, or custom-range events; add events extracted from screenshots; and label events from shared calendars.
Why use it?
It brings several calendars and manually captured plans into one view. It removes the need to check each calendar separately or retype every event from an image.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to view today’s, tomorrow’s, weekly, or custom-range events; add events extracted from screenshots; and label events from shared calendars.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/karaage0703/ai-assistant-workspace/xs-calendar
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add karaage0703/ai-assistant-workspace --skill xs-calendar
Clone the repo
git clone --depth 1 https://github.com/karaage0703/ai-assistant-workspace

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for xs-calendar

README.md
[![agentmods](https://agentmods.dev/badge/skills/karaage0703/ai-assistant-workspace/xs-calendar/github.svg)](https://agentmods.dev/skills/karaage0703/ai-assistant-workspace/xs-calendar)
Your own site
<a href="https://agentmods.dev/skills/karaage0703/ai-assistant-workspace/xs-calendar"><img src="https://agentmods.dev/badge/skills/karaage0703/ai-assistant-workspace/xs-calendar/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for xs-calendar

Your own site · 80×15
<a href="https://agentmods.dev/skills/karaage0703/ai-assistant-workspace/xs-calendar"><img src="https://agentmods.dev/badge/skills/karaage0703/ai-assistant-workspace/xs-calendar.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 842 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00067 $0.00842
Opus 5 $0.00034 $0.00421
Sonnet 5 $0.00013 $0.00168
Haiku 4.5 $0.00007 $0.00084

Measured 13d ago against content hash bdfd694550bd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

xs-calendar scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (calendar_check.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/xs-calendar/SKILL.md · 99 lines

What it actually says

calendar スキル

ICSカレンダー(Googleカレンダー等)+ 手動追加の予定(画像読み取り等)を統合して予定を確認する。

セットアップ

[SKILL_DIR]/calendar_urls.json にICS URLを登録する:

{
  "calendars": [
    {
      "name": "main",
      "url": "https://calendar.google.com/calendar/ical/xxxxx/basic.ics"
    },
    {
      "name": "family",
      "label": "家族",
      "url": "https://calendar.google.com/calendar/ical/yyyyy/basic.ics"
    }
  ]
}
  • name: カレンダー識別名(必須)
  • url: ICSのURL(必須)。Googleカレンダーの場合「設定 → カレンダーの統合 → iCal形式の非公開URL」
  • label: 表示ラベル(任意)。設定すると予定に [家族] のようなタグが付く。共有カレンダーなど、自分の予定とは限らないものに付けると便利

コマンド

cd [SKILL_DIR] && uv run python calendar_check.py [引数]
  • today / 引数なし → 今日
  • tomorrow → 明日
  • week → 今後7日間
  • 0 7 → 今日から7日間(範囲指定)
  • -7 0 → 過去7日間

画像からの予定追加

カレンダーのスクリーンショットが送られたら:

Step 1: 画像を読み取る

添付画像を Read ツールで確認する。

Step 2: 予定を抽出

画像から以下の情報を読み取る:

  • 日付、開始時刻、終了時刻、予定名
  • 終日予定かどうか

Step 3: manual_events.json に保存

[SKILL_DIR]/manual_events.json に保存。既存の予定とマージする(同じ日付の予定は上書き)。

{
  "events": [
    {
      "date": "2026-03-01",
      "time_start": "09:00",
      "time_end": "10:00",
      "summary": "ミーティング",
      "all_day": false
    },
    {
      "date": "2026-03-01",
      "summary": "有給休暇",
      "all_day": true
    }
  ],
  "updated_at": "2026-03-01T12:00:00+09:00"
}

保存ルール

  • 同じ日付の予定は上書き(最新の画像が正)
  • updated_at を更新時刻に設定
  • 過去の予定は放置OK(表示時にフィルタされる)

Step 4: 再確認

保存後、calendar_check.py を再実行して反映を確認。

チェックリスト(実行時に必ず確認)

  • calendar_urls.json が存在するか(初回はセットアップを案内)
  • 画像から予定を追加した場合、保存後に再実行して確認したか
  • 🚨 共有カレンダーの予定を「あなたの予定」と断定しない(labelで区別する)
Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 99 lines · 67 tokens per session scan A bdfd694550bd

Subscribe to this mod's changes

xs-calendar is a skill published in the GitHub repository karaage0703/ai-assistant-workspace (137 stars, last pushed 25d ago), licensed MIT. It adds 67 tokens to every session and 842 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories