Skills Cache Builder icon

Skills Cache Builder

Polls the skills folder for changes and keeps the Skills Tool cache warm. Enable Auto Rebuild to re-check on a configurable interval, or run manually to trigger a delta check on demand.

Skills Cache Builder

AI-generated

Summary

Trigger node that checks a skills folder (Google Drive, OneDrive, or local) for changes and rebuilds the in-memory and workflow-static-data cache used by the Skills Tool. It runs on activation and then optionally on a polling interval.

Inputs

  • sourceMode — Where skills live: Google Drive, OneDrive, or Local Folder (default). Determines the folder parameter and credential used.
  • googleDriveFolderId (required) — Top-level Drive folder whose sub-folders are skills (pick from list or paste ID). Shown for Google Drive; needs the googleDriveOAuth2Api credential.
  • oneDriveFolderId (required) — Top-level OneDrive folder whose sub-folders are skills (list or ID). Shown for OneDrive; needs the microsoftOneDriveOAuth2Api credential.
  • localFolderPath (required) — Absolute path to the skills folder inside the container (default /data/skills).
  • autoRebuild — Whether to re-check the folder repeatedly on a schedule (default true). If off, only the activation check and manual runs happen.
  • intervalMinutes — Polling interval in minutes (min 1, default 5). Shown only when Auto Rebuild is on.

Output shape

One item per check with JSON: status ('updated' or 'no_changes'), skillCount, cacheKey (sourceMode:folderId/path), and vfsSizeKb (only when updated).

Trigger with no inputs. Activation run warms the cache silently without emitting; scheduled runs and manual test runs emit output. Change detection: local uses SKILL.md mtime/size, Google Drive compares skill sub-folder names, OneDrive uses a delta query for folder changes, so edits to SKILL.md contents in cloud sources may not be detected until the cache expires. Rebuild reads each skill's SKILL.md (frontmatter name/description) and stores contents in a virtual file store capped at 512 KB total (skills beyond the cap are omitted). Cache entries expire after 60 minutes in static data. Skills with missing or unreadable SKILL.md are skipped. Errors if the folder is not set.

Examples

Example 1: Keep a local skills folder cache warm for an AI agent using the Skills Tool

sourceMode=localFolder, localFolderPath=/data/skills, autoRebuild=true, intervalMinutes=5

Example 2: Poll a Google Drive skills folder every 15 minutes

sourceMode=googleDrive, googleDriveFolderId chosen from list, autoRebuild=true, intervalMinutes=15

Example 3: Rebuild the cache only on demand via manual test run

sourceMode=oneDrive, oneDriveFolderId set, autoRebuild=false

Links

Discussion