Skills

Write To Notion

Write a page into Notion that someone else can find and trust, pick the right parent...

Install

npx skills add ParadevAI/Paradev --skill write-to-notion -g -a claude-code -y
Repository
ParadevAI/Paradev15.8k
Category
Writing
Updated
3d ago
License
See repository
Context cost
Lightabout 679 tokens
Runs scripts
No, instructions only

What it does

Write a page into Notion that someone else can find and trust, pick the right parent, check for the page that already exists, and structure it for a reader who was not in this conversation. Use when the user says to write up, document, save, or capture something in Notion, or to update an existing page.

Write a page someone will find later

An unfindable page is worse than no page: it splits the truth in two and neither copy gets maintained. Most of the work happens before you create anything.

1. Look for the page that already exists

Search before you create, using the words a previous author would have used, not the words in your prompt. Finding it changes the task from "write a page" to "update a page", which is almost always the better outcome, because the existing page already has the links, the history, and the readers.

Update in place when the new content belongs to the same subject. Create a new page only when the subject is genuinely new, or when the existing page is a record of a moment, a meeting note, an incident write-up, that should not be rewritten after the fact.

2. Put it where its readers are

A page's parent determines who ever sees it. Ask which team or database it belongs to rather than defaulting to the first workspace root you can write to. When a database is the right home, fill the properties, an entry with empty properties falls out of every filtered view its readers use.

If you cannot tell where it belongs, ask. A page in the wrong place is harder to find than a page that does not exist, because it looks like coverage.

3. Write for someone who was not here

Open with what the page is for, in one sentence, before any background. Then the content, in the order it gets used rather than the order you discovered it. Date anything time-bound and name the people involved, "we decided" is unreadable in six months.

Link the sources: the issue, the PR, the page you took numbers from.

4. Show it before you commit it

For anything substantial, show the user the title, the parent, and the outline before writing. Parent and title are what everyone else navigates by, and both are awkward to correct once links exist.

After writing, hand back the URL.

5. Editing without clobbering

Read the whole SKILL.md on GitHub

More in Writing