Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/notion-install-auth

@820dfc8
Run it yourself

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".

  • 2 files
  • 6 KB
  • MIT
  • Updated last month
  • GitHub
Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/notion-install-auth

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈77 tokens for metadata: the name and description. ≈820 when used: this file. ≈533 more on demand in 1 file.

Description uses 3.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈310 characters, or 3.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Approval Boundaries

Require the workspace owner for connection creation and sharing; require security review for public OAuth, user information, external distribution, or production secrets.

Error Handling

  • Never infer OAuth scopes or redirect behavior from an internal token example.
  • A connection capability does not grant access until content is shared where required.
  • Do not commit env files or access tokens.

Output

Return the connection model, workspace binding, capability matrix, shared roots, secret reference, validation evidence, lifecycle owners, and gaps. Identify assumptions, owners, expirations, and evidence gaps explicitly.

Examples

  • Onboard a read-only internal connection to a synthetic data source.
  • Document a public OAuth installation without persisting tokens in browser state.

Validation

Exercise and record these paths with expected and observed results:

  • least privilege
  • workspace binding
  • shared content
  • secret storage
  • revocation
  • negative access

Resources

  • Current first-party evidence map — recheck dated sources before relying on mutable behavior.
  • Treat observed tenant behavior as environment-specific evidence, never a universal Notion guarantee.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated last month
What it can do
Reads files Edits files
Modelinherit
argument-hint
<connection-type> <workspace> <environment>
version
1.41.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
All 5 allowed tools
ReadGlobGrepWriteEdit
Other metadata
tags
[
  "saas",
  "notion",
  "access"
]
model
inherit
effort
high
compatibility
Designed for Claude Code; live Notion actions require network access and explicit approval

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/notion-install-auth