update-variables-in-notion

Extract Beam prompt variables from Markdown files and sync metadata to a Notion database.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/beam-ai-team/beam-next-skills --skill update-variables-in-notion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-variables-in-notion
Source: https://github.com/beam-ai-team/beam-next-skills/tree/main/skills/integrations/notion-tools/update-variables-in-notion
Command: npx skills add https://github.com/beam-ai-team/beam-next-skills --skill update-variables-in-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Notion-based documentation of Beam prompt variables is manual and error-prone. This skill automates extraction of variable metadata from prompt Markdown files and syncs it to a Notion database, enabling centralized, up-to-date documentation.

Core Features & Use Cases

  • Automated extraction: Parses JSON schema blocks in Markdown prompts to identify variable names, data types, and contexts.
  • Notion sync: Creates a new Notion database or updates existing pages with mapped fields (name, description, type, node) to document variables.
  • Duplicate handling: Detects existing variables and supports skip or update modes to preserve user content while syncing new data.

Quick Start

Run the tool on your prompt Markdown files to extract variables and sync them to Notion.

Frequently Asked Questions about update-variables-in-notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document prompt variables in Notion automatically?

Extracting and syncing prompt variables to Notion involves parsing JSON schema blocks in Markdown files to identify variable names, data types, and contexts, then mapping these fields to a new or existing Notion database.

Can I update an existing Notion database with new prompt variables without losing my notes?

Yes, the tool detects existing variables and supports skip or update modes to preserve user content while syncing new data from Markdown prompt files to your Notion database.

How does the tool infer data types for prompt chain variables?

Data type inference for prompt chain variables is driven by analyzing JSON schemas and file content within the Markdown prompts during the extraction process.

Does the Notion API sync work with a directory of prompt files or only a single file?

The Notion API sync supports processing both a single Markdown file and an entire directory, extracting variables and mapping metadata to database properties at scale.

What is the best way to refine variable descriptions before syncing to Notion?

Use the optional review step to refine variable descriptions and inferred data types mapped from JSON schemas and file content before syncing them to your Notion database.

Why are my prompt variables not syncing correctly to the Notion database properties?

Variables may fail to sync if Markdown files lack proper JSON schema blocks for extraction, or if the variable name, data type, and node mapping to Notion database properties is misconfigured.