カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。

MITAuto-check passedProductivity & Automation

Install Xs Calendar

skills CLI
$ npx skills add karaage0703/ai-assistant-workspace --skill xs-calendar -a claude-code

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

GitHub CLI
$ gh skill install karaage0703/ai-assistant-workspace xs-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/karaage0703/ai-assistant-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xs-calendar .claude/skills/xs-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
xs-calendar
GitHub stars
136
Token cost
~441 tokens
SKILL.md length
67 words
Files
3
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。

  • Works in 4 steps: 画像を読み取る → 予定を抽出 → manual_events.json に保存 → …
  • Productivity & Automation work in your project
  • SKILL.md covers セットアップ, コマンド, 画像からの予定追加 and チェックリスト(実行時に必ず確認)
  • Runs Python scripts from its folder; calls uv; reaches calendar.google.com

What it does

Xs Calendar is an agent skill from karaage0703/ai-assistant-workspace. カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `calendar_check.py`).

It sits in Productivity & Automation. It works with Google Calendar. The licence is MIT.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/xs-calendar”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 画像を読み取る
  2. 予定を抽出
  3. manual_events.json に保存
  4. 再確認

What it can do on your machine

Read from SKILL.md and the folder at commit c689862. 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 script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • calendar.google.com

    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

Xs Calendar loads about 441 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 67 words of instructions outside code blocks.

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

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 karaage0703/ai-assistant-workspace at commit c689862, republished under its MIT licence (© karaage0703). 67 words, ~441 tokens.

Download SKILL.mdSave it as .claude/skills/xs-calendar/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
xs-calendar
description
カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。`/calendar` で発動。

calendar スキル

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

セットアップ

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

json
{
  "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: 表示ラベル(任意)。設定すると予定に [家族] のようなタグが付く。共有カレンダーなど、自分の予定とは限らないものに付けると便利

コマンド

bash
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 に保存。既存の予定とマージする(同じ日付の予定は上書き)。

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で区別する)

© karaage0703, 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 2 other files in skills/xs-calendar of karaage0703/ai-assistant-workspace.

  • SKILL.md
  • calendar_check.py
  • pyproject.toml

Open the folder on GitHubat commit c689862

Compare with similar skills

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

Xs Calendar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xs Calendar this skillkaraage0703/ai-assistant-workspace136—~441Automated safety check: PassMIT
Gcclibadlogic/pi-skills2.6k—~530Automated safety check: PassMIT
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
Composio Cloud Toolsquarqlabs/argus279—~543Automated safety check: PassApache-2.0
Canonical SchemaNxcoreAI/EverRoom3k—~895Automated safety check: PassCustom licence
Google CalendarNeverSight/learn-skills.dev2172 repos~826Automated safety check: PassNone

Similar skills

  • Gccli

    badlogic/pi-skills

    Google Calendar CLI for listing calendars, viewing/creating/updating events, and checking availability.

    2.6k GitHub stars~530 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Google Workspace

    yc-software/qm

    Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.

    15k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Composio Cloud Tools

    quarqlabs/argus

    Routes requests to external SaaS apps such as GitHub, Gmail, Google Calendar, Slack, Notion and Linear through cloud tools, with safeguards on irreversible actions.

    279 GitHub stars~543 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Canonical Schema

    NxcoreAI/EverRoom

    canonical schema 字段语义与各 provider 原始格式要点(gmail/outlook/google-calendar)。产出格式映射时使用。

    3k GitHub stars~895 tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Google Calendar

    NeverSight/learn-skills.dev

    Interact with Google Calendar via the Google Calendar API – list upcoming events, create new events, update or delete them.

    217 GitHub starsUsed in 2 repos~826 tokens
    Productivity & AutomationAuto-check passed
  • Google Calendar

    earlyaidopters/claudeclaw

    Manage your Google Calendar from Claude Code. An agent skill from earlyaidopters/claudeclaw.

    173 GitHub stars~1.2k tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check: notes

More from karaage0703/ai-assistant-workspace

All 23 skills in this repo
  • Xs Arxiv

    karaage0703/ai-assistant-workspace

    arXiv論文の検索・トレンド発見・詳細分析を行う統合スキル。興味度スコアでユーザーに刺さる論文を自動選定。PDF全文読み込み・Notion蓄積対応。「arXivチェックして」「論文検索」「論文分析して」で使用。

    136 GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed
  • Xs Multi Agent

    karaage0703/ai-assistant-workspace

    異なるproviderのAI(Codex/Claude/Grok/Cursor/Antigravity等)から独立意見を集め、共通論点で相互検討して統合する。最初に利用可能エージェントを検出する。「みんなで考えて」「マルチエージェントで分析して」「複数のAIでレビューして」と言われたら使う。

    136 GitHub stars~1.8k tokensUpdated 18 days ago
    Auto-check passed
  • Xs Podcast

    karaage0703/ai-assistant-workspace

    ポッドキャストの音声取得・文字起こし・まとめを行う統合スキル。「ポッドキャストまとめて」「音声配信をダウンロード」「Podcastの内容を教えて」で使用。

    136 GitHub stars~557 tokensUpdated 18 days ago
    Auto-check passed
  • Xs Skill Creator

    karaage0703/ai-assistant-workspace

    スキルの作成・改善を行うスキル。既存スキルの分析から抽出したパターンとテンプレートで統一感のあるスキルを効率的に作成。スキルを作りたい、新しいスキルを追加したい、スキルを改善したい、SKILL.mdを書きたい場合に使用。

    136 GitHub stars~1k tokensUpdated 18 days ago
    Auto-check passed
  • Xs Bridge Ideas

    karaage0703/ai-assistant-workspace

    ワークスペース内の遠い知識や活動をつないで、新しいアイデアを生成する思考支援スキル。過去記事・メモ・発信資産から企画や実装ネタを出したい時に使用。「アイデア出して」「知識をつないで」「一見関係ないものをつないで」で使用。

    136 GitHub stars~487 tokensUpdated 18 days ago
    Auto-check passed
  • Xs Cat Diary

    karaage0703/ai-assistant-workspace

    猫の写真を自動判定して猫日記を作成するスキル。写真を送ると猫かどうか判定し、猫ならNotion猫日記DBに自動保存。毎週ベストショットを選出。「猫日記」「ねこ日記」「猫写真」「今週のベストショット」で使用。

    136 GitHub stars~425 tokensUpdated 18 days ago
    Auto-check passed

Works with

Questions about Xs Calendar

What does Xs Calendar do?

カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。. Xs Calendar is an agent skill from karaage0703/ai-assistant-workspace.

When should I use Xs Calendar?

Xs Calendar fits situations like: productivity & Automation work in your project.

How do I install Xs Calendar in Claude Code?

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

How do I install Xs Calendar in Codex?

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

Can I use Xs 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 karaage0703/ai-assistant-workspace --skill xs-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/xs-calendar, .gemini/skills/xs-calendar, .github/skills/xs-calendar and .opencode/skills/xs-calendar in your project.

What does Xs Calendar need to run?

Going by SKILL.md and its folder, Xs Calendar needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Xs Calendar access the network?

SKILL.md names 1 domain. In commands or code: calendar.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Xs 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. Review the folder before installing.

What licence does Xs Calendar use?

Xs Calendar 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 Xs Calendar use?

About 441 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 Xs Calendar?

Skills that share tags, products or a category with Xs Calendar: Gccli (badlogic/pi-skills, 2.6k stars), Google Workspace (yc-software/qm, 15k stars), Composio Cloud Tools (quarqlabs/argus, 279 stars) and Canonical Schema (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xs Calendar?

karaage0703 (a GitHub user) maintains it in karaage0703/ai-assistant-workspace, which has 136 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on September 23, 2026.

Source: karaage0703/ai-assistant-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.