Agent skill · software engineering · jeremylongshore
notion-core-workflow-a
Analyze and query a Notion data source with version-correct filters, pagination, and completeness evidence. Use when retrieving structured workspace records. Trigger with "query Notion data source", "filter Notion records", or "paginate Notion data".
Why this skill is useful
Provides specific commands and patterns for querying and managing Notion databases that the AI wouldn't reliably generate on its own.
What it needs
Requires npm installed locally. Requires notion account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Notion Data-Source Query Workflow Overview Analyze and query a Notion data source with version-correct filters, pagination, and completeness evidence.. This workflow produces an auditable decision or artifact before any live action. Prerequisites Current first-party Notion documentation and the selected integration's tested API-version contract. A named workspace owner, content or data owner, and operation owner. Synthetic or approved non-production fixtures with secrets and workspace content removed. Current Contract Modern Notion APIs separate the database container from each data source schema. Query operations take a data-source ID; filters and sorts must match that data source's current property schema. Recheck the dated evidence map before relying on mutable fields, endpoints, versions, limits, or delivery behavior. Authentication Use read-content capability and explicit access to the target content. Record the connection alias, not its bearer value. Instructions 1. Retrieve database metadata and resolve the intended data-source ID by evidence, not name alone. 2. Retrieve the data-source schema and map requested fields to stable property IDs where practical. 3. Compile and review filters, sorts, page size, and output minimization. 4. Paginate until the contract says complete while preserving cursors and page counts. 5. Normalize page property values without assuming every property is populated or returned inline. 6. Reconcile row counts, duplicate IDs, missing pages, and the extraction watermark. Tool Discipline Use Read, Glob, and Grep to inspect documentation, configuration, code, fixtures, and evidence. Use Write and Edit only for approved repository artifacts. Invocation alone does not authorize network access, credentials, workspace content, user data, file transfer, deployment, capability or sharing changes, writes, spend, or deletion. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/notion-core-workflow-a--f3d164