Agent skill · software engineering · jeremylongshore
glean-prod-checklist
Pre-launch: All datasources indexed and searchable.
Why this skill is useful
Adds a validation script for Glean API readiness checks and detailed error handling procedures that aren't in public documentation.
What it needs
Requires npm installed locally. Requires glean account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Glean Production Checklist Overview Glean provides enterprise search across all company data sources with AI-powered ranking and document understanding. A production integration requires all connectors indexed, document permissions correctly mapped, and search quality validated. Failures mean employees find stale documents, see content they lack permission for, or get zero results when data exists. Authentication & Secrets [ ] GLEANAPIKEY stored in secrets manager (not config files) [ ] Indexing API token separated from Search API token [ ] Key rotation schedule documented (quarterly cycle) [ ] Separate credentials for staging/prod environments [ ] Service account permissions scoped per data source connector API Integration [ ] Production base URL configured (https://api.glean.com/v1) [ ] Rate limit handling with exponential backoff [ ] All data source connectors configured and initial crawl complete [ ] Document permission mapping tested with different user roles [ ] Connector sync scheduled (daily cron or event-driven webhooks) [ ] Bulk indexing supports incremental updates (not full re-index) [ ] Search query tested across all indexed data sources Error Handling & Resilience [ ] Circuit breaker configured for Glean API outages [ ] Retry with backoff for 429/5xx responses [ ] Connector sync failure detection within 1 hour [ ] Stale index detection (alert if last update > 24 hours) [ ] Document permission errors logged (access denied on indexed docs) [ ] Fallback search plan if Glean is unavailable Monitoring & Alerting [ ] API latency tracked per endpoint (search, indexing) [ ] Error rate alerts set (threshold: >3% over 5 minutes) [ ] Connector health dashboard showing sync status per source [ ] Search quality metrics tracked (click-through rate, zero-result rate) [ ] Index document count monitored for unexpected drops Validation Script Error Handling Check Risk if Skipped Priority ------- ---------------- ---------- Permission mapping Users see unauthorized docum …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/glean-prod-checklist