Release Notes Agent Template: GitHub to Notion

How the agent turns merged PRs into structured release notes in four steps

A real working agent you can deploy

This repo uses SCALEKIT_DEFAULT_IDENTIFIER to run all API calls on behalf of one user. In production, populate user_mapping.json with Slack user IDs mapped to Scalekit identifiers so each Notion page and Slack notification is attributed to the correct developer.

Authorize, then orchestrate

sk_connectors.py

settings.py loads and validates all env vars at startup. get_authorization_url() generates a magic link for GitHub, Notion, or Slack whenever a connection needs (re-)authorization. execute_action_with_retry() wraps every API call with exponential-backoff retry and automatic auth-expiry detection.

sk_connectors.py

Copy

Settings.load_env()
Settings.validate()  # fails fast if required vars missing

for service in ["github", "notion", "slack"]:
    url = get_authorization_url(
        service, SCALEKIT_DEFAULT_IDENTIFIER
    )
    if url:  # None when already ACTIVE
        print(f"Authorize {service}:\n{url}")

Poll GitHub for merged PRs

polling_server.py

Create Notion page for each PR

notion_service.py

Post Slack notification with link

sk_connectors.py

Agents that write release notes, without the auth plumbing

Three things you'd otherwise build: GitHub OAuth for PR data, Notion API credentials with database access, and Slack credentials. Handled.

Install

Copy Copied

npx @scalekit-inc/cli setup
# select your coding agent
# enable scalekit MCP server on coding agent

terminal

Copy Copied

npx @scalekit-inc/cli setup
# select your coding agent
# enable scalekit MCP server on coding agent

terminal

Copy Copied

npx @scalekit-inc/cli setup
# select your coding agent
# enable scalekit MCP server on coding agent

terminal

Copy Copied

npx @scalekit-inc/cli setup
# select your coding agent
# enable scalekit MCP server on coding agent

terminal

Copy Copied

npx @scalekit-inc/cli setup
# select your coding agent
# enable scalekit MCP server on coding agent

Prompt

Copy Copied

You have the Scalekit authstack plugin installed (AgentKit + SaaSKit skills and MCP auth). Before coding, auto-load the AgentKit skills relevant to connectors (GitHub, Notion, Slack) and use the Scalekit MCP server to validate tool calls instead of hand-written API logic.

Poll GitHub for merged PRs (idempotent — track processed PRs). Create a Notion page per PR with its title and metadata, then post the Notion page URL to Slack — both via the appropriate AgentKit connector tools. Ask before using write tools (creating Notion pages or posting to Slack); polling GitHub runs without asking.

Why choose Scalekit