# Notion Skills API — skills for ChatGPT and Claude
Use three corresponding sections to show how shared knowledge flows: edit together, enter the repository, then be used by different agents.
```motion-demo
{
"id": "sequence",
"title": "Overall choreography",
"src": "demos/sequence.html",
"duration": 23.766788,
"status": "authored",
"description": "Motion and composition example",
"initialTime": 6,
"params": [
{
"key": "title",
"label": "Sample main copy",
"type": "text",
"value": "Edit skills together",
"maxLength": 60
},
{
"key": "accent",
"label": "Accent color",
"type": "color",
"value": "#2f91cb"
}
],
"presets": [
{
"label": "Default content",
"values": {
"title": "Edit skills together",
"accent": "#2f91cb"
}
},
{
"label": "OpenDesign adaptation",
"values": {
"title": "OpenDesign",
"accent": "#7050da"
}
}
]
}
```
## Follow every message with a specific interface
Follow the collaborative-editing message with the skill document, the automatic-sync message with the repository directory, and the cross-agent message with the consumption interface. Short headings appear first, immediately followed by interfaces; give the three sections similar holds to establish a clear rhythm.
| Time | Section |
|---|---|
| 0.00–2.00s | Collaborative editing message |
| 2.00–6.00s | Skill page |
| 6.00–8.00s | Synchronization message |
| 8.00–12.00s | Repository directory |
| 12.00–14.00s | Cross-agent message |
| 14.00–18.00s | Agent use |
| 18.00–21.00s | Summary |
| 21.00–23.77s | Brand |
## One document across three containers
Keep the skill name and file identity visible in the editor, repository and agent windows. Change containers during transitions while retaining key terms, so viewers can recognize the same content without floating arrows.

## Make content more prominent than application decoration
White backgrounds, thin borders and medium-bold sans-serif headings create a lightweight tool style. Use light blue, apricot and purple only to distinguish sections and key selections; give body text ample line spacing, with one focal point each in the repository hierarchy and agent input area.
## Adapt to specifications or design systems
Choose content that can be shared across tools and align its editing name, repository file and agent invocation text. Preserve authoring → distribution → usage, and have each interface show its specific role.
## Color and typography
Medium-bold sans-serif headlines; fine-bordered interface and small functional text.
#ffffff · #191919 · #2f91cb · #f2e1bb · #aea0ce
## Elements and production rules
Skill document / Repository directory / Multiple agent windows / Message captions
- The same skill moves from document editing to repository synchronization to use by multiple agents, retaining its identity across containers.
- Short messages lead and corresponding interfaces follow, creating a three-part structure.
## Content replacement
- Adapt to specifications, design systems or other shared knowledge; preserve authoring → distribution → consumption.
## Production parameters
[Visuals and objects](style.json) · [Section timing](timeline.json) · [Position data](tracks.json) · [File manifest](manifest.json)
This specification is based on the reference video. The HTML provides editable choreography examples; each file identifies the source, precision and valid interval of its data.
```motion-board
{
"version": 1,
"brand": "Notion",
"id": "V088",
"palette": [
"#ffffff",
"#191919",
"#2f91cb",
"#f2e1bb",
"#aea0ce"
],
"typography": "Medium-bold sans-serif headlines; fine-bordered interface and small functional text",
"sample": "Edit skills together",
"objects": [
"Skill document",
"Repository directory",
"Multiple agent windows",
"Message captions"
],
"frames": [
{
"path": "assets/reference-1.jpg",
"timeSeconds": 0.0,
"frameId": "K0001",
"role": "reference-evidence",
"status": "measured"
},
{
"path": "assets/reference-2.jpg",
"timeSeconds": 2.000010226741468,
"frameId": "K0005",
"role": "reference-evidence",
"status": "measured"
},
{
"path": "assets/reference-3.jpg",
"timeSeconds": 8.000040906965872,
"frameId": "K0019",
"role": "reference-evidence",
"status": "measured"
},
{
"path": "assets/reference-4.jpg",
"timeSeconds": 12.000061360448807,
"frameId": "K0029",
"role": "reference-evidence",
"status": "measured"
},
{
"path": "assets/reference-5.jpg",
"timeSeconds": 18.000092040673213,
"frameId": "K0045",
"role": "reference-evidence",
"status": "measured"
},
{
"path": "assets/reference-6.jpg",
"timeSeconds": 21.000107380785416,
"frameId": "K0051",
"role": "reference-evidence",
"status": "measured"
}
],
"stages": [
{
"start": 0,
"label": "Collaborative editing message",
"end": 2,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 2,
"label": "Skill page",
"end": 6,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 6,
"label": "Synchronization message",
"end": 8,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 8,
"label": "Repository directory",
"end": 12,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 12,
"label": "Cross-agent message",
"end": 14,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 14,
"label": "Agent use",
"end": 18,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 18,
"label": "Summary",
"end": 21,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
},
{
"start": 21,
"label": "Brand",
"end": 23.766788,
"status": "inferred",
"basis": "Representative-frame review; approximate boundaries"
}
],
"duration": 23.766788,
"fontFamily": "Arial, sans-serif"
}
```