skill-sync

To sync local SKILL.md files to a Notion database, this Skill scans your workspace for skills/*/SKILL.md files and upserts their content as pages in Notion's System Skills database. It requires a configured Notion integration with database access.

Markdown skill documentation sync works with Notion by extracting metadata from local SKILL.md files and storing the full Markdown content inside a code block on the corresponding Notion page. This ensures your local definitions match the cloud database.

Yes, you need a Notion integration with explicit access to the System Skills database to sync markdown documentation. This connection is required for the Skill to authenticate and upsert page content directly into your Notion workspace.

Yes, you can update multiple SKILL.md definitions in Notion at once. The Skill automatically scans the entire skills directory for all SKILL.md files and applies batch updates to the Notion System Skills database.

The best way to manage skill definitions across local and Notion environments is using an automated sync tool that scans local markdown files and upserts them to a centralized database. This maintains version consistency without manual duplication.

A limitation of syncing markdown content to Notion is that the full text is stored inside a code block rather than native Notion blocks. This preserves the original formatting but restricts direct editing using Notion's standard rich text editor.