Software captain 423af2bf54 Clarify page read/create guidance in notion-cli skill (#5)
## Summary
- add an explicit `ntn pages get <page-id>` line to the `notion-cli`
skill
- steer Markdown page-content workflows toward `ntn pages create` / `ntn
pages update`
- replace the page markdown example so it no longer uses `ntn api
v1/pages`
- use the body-only `ntn pages create` form that was verified end to end
against a page parent

## Validation
- ran `ntn pages --help`
- ran `ntn pages get --help`
- ran `ntn pages create --help`
- ran a live `ntn pages create --parent page:<id> --content ...` flow,
read the page back with `ntn pages get`, and trashed it afterward
- confirmed the H1-title form currently returns `body.title should be
not present` under a page parent
- ran `git diff --check`

## Explainer
-
https://dev.notion.so/Explainer-notion-cli-skill-page-read-guidance-356b35e6e67f815aae6fc64df8f0323c

---------

Co-authored-by: Codex Agent <codex-agent@openai.com>
Co-authored-by: vr <varun@makenotion.com>
2026-05-04 17:10:17 -04:00
2026-03-16 18:19:52 -04:00

Notion Skills

Agent skills for working with Notion.

Install

We recommend the skills CLI.

# Install all skills
npx skills add makenotion/skills

# Install a specific skill
npx skills add makenotion/skills --skill notion-cli

Available Skills

Skill Description
notion-cli Install and use the Notion CLI (ntn) for workers, public API requests, and file uploads.
S
Description
Use the Notion CLI (ntn) to interact with the Notion API, manage workers, and upload files. Use when the user asks to "call the Notion API", "deploy a…
Readme 63 KiB
Languages
Markdown 100%