All use cases

Work

Notion Skills API: edit in Notion, ship via GitHub, agents run

Skills lived on someone's laptop. Editors used GitHub. Non-engineers could not touch them.

Share

What hurt

知の庭師 (@byethankyou2) called Notion's Skills API a shift: AI skills used to mean someone installed locally and said it was handy — users downloaded each time; editors lived on GitHub; non-engineers barely touched them. Now Notion is the hub. Write the skill as a Notion page, edit it as a team, sync to GitHub via the Skills API. Then Claude, ChatGPT, and Grok Bot can use it — no per-person download; shortcuts work too. Edit = Notion. Distribute = GitHub. Run = each agent. Sales, ops, and marketing can fix the page in the Notion they already use; engineers do not have to be the only GitHub guards. Tip only — do not invent API steps beyond that split. Not affiliated with xAI or Notion.

What to install or create

Write the skill as a Notion page. Team-edit there. Sync to GitHub. Agents (including Grok Bot) run it. No extra download theater.

Bots

  • Skill runner

    Runs the team skill after Notion→GitHub sync. Does not invent new API steps.

Plugins

  • Notion

    Required

Files

  • One Notion page that is the skill. GitHub is the distribute hop the author named.

Routines

  • None on the first run. Watch one manual pass first.

The prompt

This is a tip, not a pasteable system prompt. The author did not publish one. Follow the first-run steps.

First run

  1. 1Read https://x.com/byethankyou2/status/2100731484550373497. Tip only — do not invent Skills API calls.
  2. 2Write one real skill as a Notion page your team can edit.
  3. 3Use the Skills API sync to GitHub the way Notion documents — engineers keep the repo; everyone else edits the page.
  4. 4Point Grok Bot (or your other agents) at that shared skill. Skip per-person downloads.
  5. 5You still approve anything the skill would send, spend, or publish.

Approval fence

Page edits are drafts until you publish the sync. Agents still do not send, spend, or ship customer-facing copy without your yes.

What to tweak

Steal edit-in-Notion / ship-via-GitHub / agents-run. The hub is who can edit.

Source

知の庭師 @byethankyou2 · Original post

Not affiliated with xAI. We did not write this prompt. Third-party template terms still apply.

Browse templates

Browse team blueprints

Pro pack

Want the full setup, not just the idea?

Pro packs give you the job text, prompts, schedules and pitfalls for popular use-cases.

See Pro