Agent skill · software engineering · jeremylongshore
glean-upgrade-migration
Check Glean developer changelog for API changes.
Why this skill is useful
Adds executable scripts for detecting API versions and migrating document schemas that are specific to Glean's platform.
What it needs
Requires npm installed locally. Requires glean account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Glean Upgrade & Migration Overview Glean is an enterprise search platform that indexes documents across SaaS tools via connectors and exposes Search and Indexing APIs. Migrations involve connector schema changes, search API response format updates, and document permission model upgrades. Tracking API versions is critical because Glean's Indexing API enforces document schema validation — adding required fields or changing permission structures in a new version will cause bulk indexing failures and stale search results if connectors are not updated in lockstep. Version Detection Migration Checklist [ ] Review Glean developer changelog for Indexing API schema changes [ ] Audit custom connectors for deprecated document fields [ ] Verify objectType definitions match current Glean schema requirements [ ] Check if new required fields were added to document permission model [ ] Test search API response parsing — results[].snippets format may change [ ] Update datasource configuration if connector authentication method changed [ ] Validate bulk indexing with a small document batch before full re-index [ ] Check people API for identity resolution field changes [ ] Update search query syntax if faceted search operators were modified [ ] Monitor indexing error dashboard for 48 hours post-migration Schema Migration Rollback Strategy Error Handling Migration Issue Symptom Fix ---------------- --------- ----- Document schema validation failure 400 with missing required field: viewURL Add viewURL to all documents before re-indexing Permission model mismatch Documents indexed but not searchable by expected users Migrate flat allowedUsers strings to structured user objects Connector auth expired 401 Unauthorized on bulk index Rotate API token in Glean admin and update connector config Search response format changed Client crashes parsing snippets as string instead of array Handle both string and Snippet[] return types Datasource quota exceeded 429 during bulk re-index Implement rate …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/glean-upgrade-migration