{"id":41170,"plugin_id":"plugin_asdk_app_69882957c72881918be2ef40215b14a2","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-24T12:57:49.670Z","digest":"09cdba961d0961ad0b82f2b7c56049d841f43243a36f480b2890405c08268f3e","against":null,"payload":{"description":"Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).","included_files":[{"relative_path":"references/reference.md","size_in_bytes":39125}],"name":"pencil-spaces","skill_md_contents":"---\nname: pencil-spaces\ndescription: Use when working with Pencil Spaces data through the pencil-spaces connector — listing or managing an institution's users, virtual classrooms (Spaces), scheduled events, programs, cohorts, sessions, recordings, transcriptions, attendance, availability, sites, custom attributes, alerts, or webhooks. Covers ID formats, base64-encoded filters, custom-attribute syntax, and multi-step workflows (e.g. finding a recording or attendance for a class).\n---\n\n# Pencil Spaces\n\nPencil Spaces is a virtual-classroom platform. The connector exposes read\ntools for every entity and opt-in write tools (create/update only — nothing\ncan be deleted). For the complete per-tool parameter tables and response\nshapes, read `references/reference.md`.\n\n## Conventions that prevent failed calls\n\n- **IDs**: every `*Id` parameter is a 24-character hex MongoDB ObjectId\n  (`507f1f77bcf86cd799439011`). Never pass names or emails where an ID is\n  expected — look the entity up first.\n- **`filters` parameters are base64-encoded JSON.** Build the JSON object,\n  then pass `base64(JSON.stringify(obj))`. The shape differs per tool —\n  check `references/reference.md` before encoding. Common mistakes: passing\n  raw JSON (must be base64), or nesting `timeRange` wrong for events\n  (`{\"timeRangeStart\": \"...\", \"timeRangeEnd\": \"...\"}` flat keys are\n  accepted and normalized).\n- **Custom attributes** are arrays of `\"keyId:valueId\"` strings — both\n  halves are IDs from `get_attributes`, not display names.\n- **Attendance statuses are Pascal case**: `Present`, `Late`, `Absent`,\n  `Left`, `Excuse` (write) — uppercase variants are rejected.\n- **Availability slots**: `day` is 0–6 (0 = Sunday); times are `HH:mm`\n  24-hour strings when setting, minutes-from-midnight integers when reading.\n- **Dates**: ISO 8601 timestamps; program cancellations use `YYYY-MM-DD`.\n- **Pagination**: `pageNumber` (default 1) and `pageSize` (default 25,\n  max 100) on list tools.\n- **User references** in event/space tools are objects with exactly one of\n  `userId` or `email` — never bare strings.\n\n## Multi-step workflows\n\n- **Recording/transcript of a class**: `list_sessions` (or `list_events` →\n  session) → `get_session` → `get_space_recordings` → `download_recording`\n  (presigned URL) and/or `get_transcription`.\n- **Attendance for a class**: `list_events` (base64 time filter) →\n  `get_attendance` with the eventId. Only past events have attendance.\n- **Who is free at time X**: `get_available_users` with the window, or\n  `get_user_availability` for one person.\n- **Program structure**: `list_programs` → `get_program` → `list_cohorts` /\n  `list_program_cancellations`.\n- **Entity graph**: program → cohorts → events → space → sessions →\n  recordings → transcription. Users belong to sites; attributes tag\n  users/spaces/events.\n\n## Write tools\n\nWrite tools (create/update only) execute only when the connection was\ngranted write access — the user picks \"Read and edit\" on the OAuth consent\nscreen when connecting. If a write call returns \"Write operations are\ndisabled for this connection\", tell the user to reconnect and choose\n\"Read and edit\"; do not retry.\n\nBefore any write, confirm the target with a read (e.g. `get_event` before\n`update_event`). Updates replace provided fields wholesale — for list-valued\nfields (attendees, organizers, cohort members, availability slots) fetch the\ncurrent value, modify it, and send the full list back.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}