Using notion-skills

notion-skills is an app-store-style CLI for AI coding agent skills. Each Notion database the user has linked is a "source"; they install what they want from any source, publish to a chosen source, sync keeps installed skills fresh across all sources.

Mental model

A skill is in one of three states:

• Installed — has a manifest entry. Invokable via the agent CLI's /<slug> shortcut.
• Draft — not yet ready for team consumption. Two flavors: (1) local-only (central-store dir exists, no manifest entry, no Notion row), or (2) Notion-side (page exists with Published = false). Both share the ✎ marker in list.
• Available — Notion row with Published = true, not installed on this machine.

Two further sub-states for installed skills:

• Outdated — the Notion page has changed since the user last synced.
• Local-edited — the user edited any file in the skill dir (SKILL.md or sibling) without publishing.

The verb mapping: