Agent skill · software engineering · jeremylongshore
notion-install-auth
Establish a least-privilege Notion connection and tested API contract without leaking credentials. Use when onboarding an internal connection, public OAuth connection, or personal access token. Trigger with "set up Notion auth", "create Notion connection", or "review Notion credentials".
Why this skill is useful
Adds specific commands and configuration steps for integrating with the Notion API that the AI wouldn't reliably generate on its own.
What it needs
Requires npm, pip 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 Connection and Authentication Intake Overview Establish a least-privilege Notion connection and tested API contract without leaking credentials.. 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 Notion supports internal connections, public OAuth connections, and personal access tokens with different ownership and access behavior. REST calls require bearer authentication and an explicit tested Notion-Version contract. Recheck the dated evidence map before relying on mutable fields, endpoints, versions, limits, or delivery behavior. Authentication Record credential issuer, connection or user owner, workspace binding, capabilities, shared roots, expiry or refresh behavior, storage, rotation, and revocation without storing the secret value. Instructions 1. Choose the connection type from distribution, tenant, and user-context requirements. 2. Define the minimum content, comment, and user capabilities plus exact shared fixture roots. 3. Select and test an SDK and API-version combination against current upgrade guidance. 4. Provision the credential through the approved secret manager and record a fingerprint. 5. Run bot identity plus one explicitly shared read-only fixture check. 6. Document rotation, OAuth refresh if applicable, revocation, reauthorization, and production promotion. 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-install-auth