connections — Claude Code skill: what it does, how to install
Configures typed provider connections and connection-bound triggers in Notion App workflows.
npx skills add makenotion/notion-cookbook --skill connections -a claude-codeWhat connections does
The skill guides the agent in setting up typed provider connections and triggers for Notion App workflows. It enforces reading SDK documentation before changing any connection logic.
Before writing, editing, or debugging connection code, the agent must inspect node_modules/@notionhq/apps/skills/connections/SKILL.md from the project root. Without @notionhq/apps installed, the skill blocks further modifications.
If that file is missing, install the project dependencies. Updating @notionhq/apps to a release with this skill also solves the issue.
What it helps with
- set up typed provider connections for Notion App workflows
- add triggers bound to specific connections
- troubleshoot connection logic using SDK instructions
- verify connection guidelines before editing code
Example prompts for the agent
- Configure a typed provider connection for this Notion App workflow
- Add a connection-bound trigger to the Notion App project
- Troubleshoot connection code following
@notionhq/appsguidelines
How to install connections
1Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill connections -a claude-code2Manually: put the files in place
~/.claude/skills/connections/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/connections/
1Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill connections -a codex2Manually: put the files in place
.agents/skills/connections/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill connections -a cursor2Manually: put the files in place
.cursor/skills/connections/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/notion-cookbook connections2Manually: put the files in place
.github/skills/connections/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill connections -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/notion-cookbook --path apps/agents/skills/connectionsManually: put the files in place
.devin/skills/connections/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill connections -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about connections
How do I install connections in Claude Code?
Run npx skills add makenotion/notion-cookbook --skill connections -a claude-code. The skill file is placed at ~/.claude/skills/connections/SKILL.md.
What does the connections skill do?
It configures typed provider connections and connection-bound triggers in Notion App workflows. The agent consults SDK guidelines before editing connection code.
What if the SKILL.md file in node_modules is missing?
Install your project dependencies. If the file remains unavailable, update @notionhq/apps to a release that includes the skill.
Source text
SKILL.md · MIT
--- name: connections description: Configure and use typed provider connections and connection-bound triggers in Notion App workflows. user-invocable: false --- # App connections Before creating, modifying, or troubleshooting connection code, read `node_modules/@notionhq/apps/skills/connections/SKILL.md`. Resolve this path relative to the App project root. Follow the instructions in that file. If the file is missing, install the project dependencies. If it remains missing, update `@notionhq/apps` to a release that includes the skill. Do not continue with connection changes until you can read the SDK skill.
© makenotion · MIT · makenotion/notion-cookbook