菜单
NeuroSkill calendar integration — fetch OS calendar events (macOS EventKit, Linux iCal files, Windows Outlook/Calendar). Shows today's meetings, upcoming events, and access status. Use when the user asks about their schedule, meetings, events, appointments, or what they have coming up.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Skill index and overview — lists all available NeuroSkill skills, tools, and explains how skill loading works.
NeuroSkill activity tracking — file interactions, terminal commands, focus sessions, meetings, clipboard, productivity scoring, weekly digest, brain awareness, and multi-monitor awareness. Tracks files, terminal commands (50+ categories), dev loops, zone switches, EEG-correlated struggle prediction, and task type detection. Use when asking about coding activity, file history, productivity, meetings, terminal usage, dev workflow, or brain state.
NeuroSkill Do Not Disturb automation — EEG-driven focus detection that activates OS-level DND and optional grayscale display when sustained attention exceeds a threshold. Shows rolling average, sample window, and OS state. Supports force-override on/off. Use when managing focus-based DND automation, grayscale mode, or checking DND status.
Meditation protocols — guided, unguided, mantra, visualization, loving-kindness, body scan, open awareness, and EEG-biofeedback meditation with real-time neural tracking.
Mindfulness protocols — present-moment awareness, informal mindfulness, mindful eating, mindful listening, RAIN, STOP, noting practice, and EEG-tracked mindfulness with real-time neural feedback.
NeuroSkill `label`, `search-labels`, and `interactive` commands — creating EEG text annotations, semantic vector search over labels, and cross-modal 5-layer graph search combining text, EEG similarity, and screenshot discovery with 3D visualization. Use when annotating EEG moments or searching for past states by description.
| name | neuroskill-calendar |
| description | NeuroSkill calendar integration — fetch OS calendar events (macOS EventKit, Linux iCal files, Windows Outlook/Calendar). Shows today's meetings, upcoming events, and access status. Use when the user asks about their schedule, meetings, events, appointments, or what they have coming up. |
Reads calendar events directly from the operating system:
| Platform | Source |
|---|---|
| macOS | Apple EventKit — all calendars synced to Calendar.app (iCloud, Google, Exchange, local) |
| Linux | .ics files from GNOME Calendar, Evolution, KOrganizer, Thunderbird Lightning, ~/Calendars/ |
| Windows | .ics files from Outlook / Windows Calendar app paths |
{"command": "calendar_events", "args": {"start_utc": 1774396800, "end_utc": 1774483200}}
{"command": "calendar_status"}
{"command": "calendar_request_permission"}
Getting timestamps: use the date tool first to get now_unix, then compute ranges:
start_utc = now_unix - (now_unix % 86400), end_utc = start_utc + 86400start_utc = now_unix, end_utc = now_unix + 604800calendar_eventsFetch all events overlapping [start_utc, end_utc].
| Field | Type | Required | Description |
|---|---|---|---|
start_utc | i64 | ✓ | Range start (UTC unix seconds, inclusive) |
end_utc | i64 | ✓ | Range end (UTC unix seconds, inclusive) |
Response:
{
"events": [
{
"id": "abc123@google.com",
"title": "Sprint Review",
"start_utc": 1774468800,
"end_utc": 1774472400,
"all_day": false,
"location": "Conference Room B",
"notes": "Bring laptop. Demo Q2 features.",
"calendar": "Work",
"status": "confirmed",
"recurrence": "FREQ=WEEKLY;BYDAY=WE"
}
],
"count": 1
}
status is one of "confirmed", "tentative", "cancelled".
recurrence is the raw RRULE string (not expanded — only the base instance is returned).
all_day events have start_utc at midnight UTC; end_utc is the next midnight.
calendar_statusCheck whether the app has permission to read calendars.
Response:
{ "status": "authorized", "platform": "macos" }
status values: "authorized" | "not_determined" | "denied" | "restricted"
If status is "not_determined", suggest running calendar_request_permission.
If status is "denied", direct the user to System Settings → Privacy & Security → Calendars.
calendar_request_permissionShow the macOS system permission dialog. No-op on Linux/Windows (always authorized).
Response:
{ "granted": true, "status": "authorized" }
npx neuroskill calendar # events: next 7 days
npx neuroskill calendar --start 1774396800 --end 1774483200
npx neuroskill calendar --json
npx neuroskill calendar --json | jq '.events[] | {title, start_utc, calendar}'
npx neuroskill calendar status # auth status + platform
npx neuroskill calendar permission # macOS: request system dialog
POST /v1/calendar/events { "start_utc": 1774396800, "end_utc": 1774483200 }
GET /v1/calendar/status
POST /v1/calendar/permission
"What do I have today?"
{"command": "calendar_events", "args": {"start_utc": <today_start>, "end_utc": <today_end>}}
"What's my next meeting?"
Fetch events for the next few hours, sort by start_utc, return the first future one.
"Am I free at 3pm?" Fetch events for the 1-hour window around 3pm, check if any overlap.
"How many meetings do I have this week?"
Fetch [monday_00:00, sunday_23:59], count non-cancelled events.
"What's on my calendar right now?"
start_utc = now, end_utc = now + 3600; a non-empty result means something is happening.
status | Meaning | Fix |
|---|---|---|
not_determined | Never asked | Run calendar_request_permission |
authorized | All good | — |
denied | User declined | System Settings → Privacy & Security → Calendars → enable Skill |
restricted | MDM/parental controls | Contact device administrator |
If calendar_events returns {"error": "calendar_write_only_access"}, the user chose
"Add Events Only" in the permission dialog. Run calendar_request_permission again to
prompt for full read access, or direct them to System Settings → Calendars.
On Linux and Windows access is always authorized; if events is empty, no .ics files were found in the standard locations. The user can place exported .ics files in ~/Calendars/.