Notion design skill that MUST be used whenever creating documents.

MITAuto-check passedProductivity & Automation

Install Notion Doc

skills CLI
$ npx skills add heyman333/agent-notion-template-docs --skill notion-doc -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install heyman333/agent-notion-template-docs notion-doc --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/heyman333/agent-notion-template-docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/notion-doc .claude/skills/notion-doc && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notion-doc
GitHub stars
105
Token cost
~1.1k tokens
SKILL.md length
545 words
Files
3
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Notion design skill that MUST be used whenever creating documents.

  • Works in 5 steps: Header area (required) → Notion block dictionary — pick the block… → Visual style → …
  • Asks for a document
  • SKILL.md covers 1. Header area (required), 2. Notion block dictionary —…, 3. Visual style and 4. Verify after writing, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Notion Doc is an agent skill from heyman333/agent-notion-template-docs. Notion design skill that MUST be used whenever creating documents. When the user asks for a document, report, summary, meeting notes, or review write-up in HTML/Markdown, load this skill first. The content decides the document's structure and outline; this skill only governs the Notion blocks (callouts, toggles, tables, checklists, code, columns, etc.) and visual style.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `lint.py`).

It sits in Productivity & Automation, covering Meeting notes and agendas. It works with Notion. The repository describes itself as: Make your AI agent write documents like Notion — Codex & Claude Code skill that locks document structure & Notion visual style. The licence is MIT.

When your agent uses it

  • Asks for a document
  • Review write-up in HTML/Markdown
  • Load this skill first

Example prompts

  • “/notion-doc”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Header area (required)
  2. Notion block dictionary — pick the block that fits the content
  3. Visual style
  4. Verify after writing
  5. Interaction with other skills

What it can do on your machine

Read from SKILL.md and the folder at commit 60cabd8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion Doc loads about 1.1k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 545 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from heyman333/agent-notion-template-docs at commit 60cabd8, republished under its MIT licence (© heyman333). 545 words, ~1,088 tokens.

Download SKILL.mdSave it as .claude/skills/notion-doc/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
notion-doc
description
Notion design skill that MUST be used whenever creating documents. When the user asks for a document, report, summary, meeting notes, or review write-up in HTML/Markdown, load this skill first. The content decides the document's structure and outline; this skill only governs the Notion blocks (callouts, toggles, tables, checklists, code, columns, etc.) and visual style.

Creating documents with Notion's design

This skill governs only how the document looks. The outline, sections, and flow are decided by the content and the request — no particular document format (proposal, etc.) is imposed. Instead, every document is rendered with the blocks and design language Notion provides.

1. Header area (required)

  1. Page icon: one emoji matching the document's topic, large, above the title (Notion page icon)
  2. Title: a short noun phrase
  3. Meta line: date · author · 1–2 tag pills
  4. A thin divider below the meta line

2. Notion block dictionary — pick the block that fits the content

ContentBlock
Key takeaway, the one line to emphasizeCallout (blue 💡)
Reference, supplementary infoCallout (gray)
Done, success, what went wellCallout (green ✅)
Caution, constraintsCallout (yellow ⚠️)
Warning, incident, riskCallout (red 🚨)
Opening of a long document (4+ h2s)Table of contents (toc)
Parent document, location contextbreadcrumb
Comparable, listable factssimple table
Two chunks that belong side by side2-column layout
Long details or logs that break the flow<details> toggle
Tasks, progresscheckbox list (done items get strikethrough)
Codecode block + class="language-<lang>" syntax highlighting (required)
One striking sentencequote (bold left bar)
Introducing an external linkbookmark card
A single call-to-action linkbutton block (btn)
Word-level emphasisbold, inline code, Notion text colors (t-blue etc., 5 colors)

Never use blocks as decoration — only when they match a purpose in this table.

3. Visual style

HTML documents MUST start from the template.html skeleton in this skill's directory. Do not write new CSS; use the template's classes as they are. The template's palette and dimensions are Notion's actual design-token values (see the comment next to each value). Core rules:

  • 720px content width, centered, generous whitespace — measured values as-is
  • Text color #2C2C2B, 16px/1.5, white background, minimal decoration. No shadows, gradients, or heavy background colors
  • Rounded corners use only the --radius (10px) token — shared by callouts, bookmarks, and code blocks
  • Colors come only from the template's tokens (5 callout colors, 5 text colors, --tok-* code tokens) — no new colors
  • Light/dark palettes are built in as CSS tokens and follow the viewer's theme automatically
  • Code highlighting is handled by the Prism scripts at the bottom of the template — just add the language-* class
  • Korean line breaking (word-break: keep-all) and print/PDF rules (@media print) are already in the template — do not add your own. The dark palette is wrapped in @media screen, so printing automatically falls back to light
Show full SKILL.md (140 more words)Show less

For Markdown documents, apply the same sensibility: emoji + title (h1), a meta line, callouts as > emoji **Title** — body quotes, tasks as - [ ] checklists, code in language-tagged fences.

4. Verify after writing

After writing an HTML document, check it with lint.py from this skill's directory.

bash
python3 <skill directory>/lint.py doc.html
  • css-drift — you modified the template's <style>. Restore it and change only the body
  • unknown-class — you invented a class. Pick one from the block dictionary in section 2
  • inline-style · raw-color — you styled or colored the body directly. Use template classes instead

5. Interaction with other skills

  • If another skill or host also governs presentation (a design-system skill, an artifact/preview host), take only its technical requirements — responsiveness, dark mode, sandbox constraints. This skill's style tokens take precedence
  • If charts are included, follow whatever chart skill is available for color and mark choices, but keep the layout inside this template

© heyman333, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/notion-doc of heyman333/agent-notion-template-docs.

  • SKILL.md
  • lint.py
  • template.html

Open the folder on GitHubat commit 60cabd8

Compare with similar skills

Notion Doc next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion Doc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion Doc this skillheyman333/agent-notion-template-docs105—~1.1kAutomated safety check: PassMIT
Claap Weekly RecapOthmane-Khadri/YALC-the-GTM-operating-system318—~5.4kAutomated safety check: PassMIT
Find In Notionsuperset-sh/superset15k—~763Automated safety check: PassCustom licence
Meeting Preptechwolf-ai/ai-first-toolkit132—~1kAutomated safety check: PassMIT
Granola Core Workflow Bjeremylongshore/tons-of-skills-marketplace2.8k—~1.7kAutomated safety check: PassMIT
Async Standup Compilermohitagw15856/pm-claude-skills1.4k—~1kAutomated safety check: PassMIT

Similar skills

  • Claap Weekly Recap

    Othmane-Khadri/YALC-the-GTM-operating-system

    Turns a week of Claap-recorded sales calls into action items and focus blocks on a Notion Kanban, delivered with a Slack summary.

    318 GitHub stars~5.4k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Find In Notion

    superset-sh/superset

    Find what the workspace already says before you answer or write — search Notion, tell the canonical page from the stale copy, and cite what you used.

    15k GitHub stars~763 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Meeting Prep

    techwolf-ai/ai-first-toolkit

    Comprehensive pre-meeting briefing that gathers all relevant context from Slack, email, Google Docs, Notion, and calendar.

    132 GitHub stars~1k tokensUpdated 10 days ago
    Productivity & AutomationAuto-check passed
  • Granola Core Workflow B

    jeremylongshore/tons-of-skills-marketplace

    Post-meeting note processing, sharing, and follow-up workflows in Granola.

    2.8k GitHub stars~1.7k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Async Standup Compiler

    mohitagw15856/pm-claude-skills

    Compile the team's REAL updates into one async standup — pull what people posted in Slack (and moved in Notion/Linear), not a template for running standups.

    1.4k GitHub stars~1k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Meeting Notes

    ericrisco/rsc-harness

    A skill your agent uses when a meeting just ended and a transcript or rough notes must become a record the absent can act on — decisions with their why, actions with an owner and a real date, open…

    180 GitHub stars~3.1k tokensUpdated today
    Productivity & AutomationAuto-check passed

Works with

Questions about Notion Doc

What does Notion Doc do?

Notion design skill that MUST be used whenever creating documents. Notion Doc is an agent skill from heyman333/agent-notion-template-docs. Notion design skill that MUST be used whenever creating documents.

When should I use Notion Doc?

Notion Doc fits situations like: asks for a document; review write-up in HTML/Markdown; load this skill first.

How do I install Notion Doc in Claude Code?

Run `npx skills add heyman333/agent-notion-template-docs --skill notion-doc -a claude-code`. Or copy the skill folder (skills/notion-doc in heyman333/agent-notion-template-docs) into .claude/skills/notion-doc in your project. Claude Code loads it when a task matches its description.

How do I install Notion Doc in Codex?

Run `npx skills add heyman333/agent-notion-template-docs --skill notion-doc -a codex`. Or copy the skill folder (skills/notion-doc in heyman333/agent-notion-template-docs) into .agents/skills/notion-doc in your project. Codex loads it when a task matches its description.

Can I use Notion Doc in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add heyman333/agent-notion-template-docs --skill notion-doc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion-doc, .gemini/skills/notion-doc, .github/skills/notion-doc and .opencode/skills/notion-doc in your project.

What does Notion Doc need to run?

Going by SKILL.md and its folder, Notion Doc needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Notion Doc access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Notion Doc safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion Doc use?

Notion Doc is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion Doc use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notion Doc?

Skills that share tags, products or a category with Notion Doc: Claap Weekly Recap (Othmane-Khadri/YALC-the-GTM-operating-system, 318 stars), Find In Notion (superset-sh/superset, 15k stars), Meeting Prep (techwolf-ai/ai-first-toolkit, 132 stars) and Granola Core Workflow B (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion Doc?

heyman333 (a GitHub user) maintains it in heyman333/agent-notion-template-docs, which has 105 GitHub stars. The repository was last updated on September 27, 2026.

Source: heyman333/agent-notion-template-docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.