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.
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
- 1Read https://x.com/byethankyou2/status/2100731484550373497. Tip only — do not invent Skills API calls.
- 2Write one real skill as a Notion page your team can edit.
- 3Use the Skills API sync to GitHub the way Notion documents — engineers keep the repo; everyone else edits the page.
- 4Point Grok Bot (or your other agents) at that shared skill. Skip per-person downloads.
- 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.
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.