Skip to content

Commit a63ced4

Browse files
committed
docs: add Notion structure mandate to weekly-update skill
1 parent c2b89ea commit a63ced4

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

skill/weekly-update/SKILL.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,35 @@ See: `/Users/joel/.config/opencode/skill/linear/SKILL.md`
217217
- **Page ID:** `2a7e06b059c480fcb93fc104a024e003`
218218
- **URL:** https://www.notion.so/vercel/DX-Weekly-Team-Updates-2a7e06b059c480fcb93fc104a024e003
219219

220+
### CRITICAL: Notion Structure Rules
221+
222+
**MANDATE: Write to EXISTING blocks, don't create new ones.**
223+
224+
The page structure is:
225+
```
226+
▶ [Date] (e.g., January 26)
227+
▶ Docs
228+
▶ Community
229+
▶ Academy ← FIND THIS EXISTING BLOCK
230+
```
231+
232+
**Publishing workflow:**
233+
1. Fetch the page to find the target date section
234+
2. Find the EXISTING Academy block nested under that date
235+
3. Write content TO that existing block
236+
4. Do NOT create a new Academy block at the wrong level
237+
238+
**If you create a new block instead of writing to the existing one, it will appear at the wrong nesting level and need manual cleanup.**
239+
240+
```
241+
# WRONG - creates orphan block
242+
notion_create_block(parent_id="<page-id>", content="Academy...")
243+
244+
# RIGHT - find existing Academy block first, then update it
245+
notion_fetch(id="<page-id>") # Find Academy block ID under target date
246+
notion_update_block(id="<existing-academy-block-id>", content="...")
247+
```
248+
220249
## Example Usage
221250

222251
```

0 commit comments

Comments
 (0)