How do I install the Hugo Notion Publish skill?

Run npx skillmds@latest add majiayu000/hugo-notion-publish in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hugo Notion Publish safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hugo Notion Publish?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hugo Notion Publish free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hugo Notion Publish?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hugo Notion Publish by majiayu000 — Agent Skill

Name: Hugo Notion Publish
Rating: 4.2 (5 reviews)
Author: majiayu000

Hugo Notion Publish

Convert Notion pages or drafts into Hugo content for this repo, including front matter, shortcodes, glossary terms, and asset placement, and publish/preview with the Hugo CLI. Use when asked to import from Notion, format content to match FORMATTING.md, or create/update posts in content/.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

Hugo Notion Publish

Overview

Turn Notion content into Hugo-ready Markdown and publish it in this site with the correct front matter, shortcodes, and assets.

Workflow

Identify the target section and slug.
Gather metadata (title, date, tags, summary, series, author, glossary terms).
Pull the source content:
- Use Notion MCP notion-search to locate the page if only keywords are provided.
- Use notion-fetch with the page URL to retrieve properties, blocks, and assets.
- If Notion MCP is unavailable, ask for a Markdown or HTML export.
Build front matter using references/hugo-frontmatter.md.
Convert Notion blocks to Hugo Markdown per references/notion-to-hugo.md and FORMATTING.md.
Write the file and place assets.
Preview or build with the Hugo CLI if requested.

Target locations

Blog posts: content/posts/<slug>.md
Images: static/images/<slug>/... referenced as /images/<slug>/file.ext
Other sections: content/<section>/ (mirror front matter fields from existing entries).

Publishing with Hugo CLI

Preview locally: hugo server -D
Production build: hugo --gc --minify
Use hugo new <section>/slug.md only to scaffold; replace front matter with the site template and remove draft.

Notion MCP helpers

Use scripts/notion_fetch_plan.py <notion-url> to generate a minimal tool-call payload for notion-fetch.

Formatting rules

Shift headings down one level (Notion H1 -> ##) so the H1 is only in front matter.
Use {{< term >}}, {{< highlight-box >}}, {{< collapse >}}, and {{< app >}} as defined in FORMATTING.md.
Keep tags lower-case and hyphenated; keep summaries to 1-2 sentences.
When updating an existing post, preserve the filename/slug and date, and set lastmod.

Quality checks

Remove Notion artifacts (export headers, "Untitled", orphaned URLs).
Ensure image paths resolve under /images/<slug>/.
Summary matches the lead and is not duplicated verbatim in the first paragraph.
Glossary terms appear in front matter or data/glossary.yaml when reused across posts.

Resources

scripts/notion_fetch_plan.py
references/hugo-frontmatter.md
references/notion-to-hugo.md
FORMATTING.md
CLAUDE.md

---name: hugo-notion-publishdescription: Convert Notion pages or drafts into Hugo content for this repo, including front matter, shortcodes, glossary terms, and asset placement, and publish/preview with the Hugo CLI. Use when asked to import from Notion, format content to match FORMATTING.md, or create/update posts in content/.--- # Hugo Notion Publish ## Overview Turn Notion content into Hugo-ready Markdown and publish it in this site with the correct front matter, shortcodes, and assets. ## Workflow 1. Identify the target section and slug. 2. Gather metadata (title, date, tags, summary, series, author, glossary terms). 3. Pull the source content: - Use Notion MCP `notion-search` to locate the page if only keywords are provided. - Use `notion-fetch` with the page URL to retrieve properties, blocks, and assets. - If Notion MCP is unavailable, ask for a Markdown or HTML export. 4. Build front matter using `references/hugo-frontmatter.md`. 5. Convert Notion blocks to Hugo Markdown per `references/notion-to-hugo.md` and `FORMATTING.md`. 6. Write the file and place assets. 7. Preview or build with the Hugo CLI if requested. ## Target locations - Blog posts: `content/posts/<slug>.md` - Images: `static/images/<slug>/...` referenced as `/images/<slug>/file.ext` - Other sections: `content/<section>/` (mirror front matter fields from existing entries). ## Publishing with Hugo CLI - Preview locally: `hugo server -D` - Production build: `hugo --gc --minify` - Use `hugo new <section>/slug.md` only to scaffold; replace front matter with the site template and remove `draft`. ## Notion MCP helpers - Use `scripts/notion_fetch_plan.py <notion-url>` to generate a minimal tool-call payload for `notion-fetch`. ## Formatting rules - Shift headings down one level (Notion H1 -> `##`) so the H1 is only in front matter. - Use `{{< term >}}`, `{{< highlight-box >}}`, `{{< collapse >}}`, and `{{< app >}}` as defined in `FORMATTING.md`. - Keep tags lower-case and hyphenated; keep summaries to 1-2 sentences. - When updating an existing post, preserve the filename/slug and `date`, and set `lastmod`. ## Quality checks - Remove Notion artifacts (export headers, "Untitled", orphaned URLs). - Ensure image paths resolve under `/images/<slug>/`. - Summary matches the lead and is not duplicated verbatim in the first paragraph. - Glossary terms appear in front matter or `data/glossary.yaml` when reused across posts. ## Resources - `scripts/notion_fetch_plan.py` - `references/hugo-frontmatter.md` - `references/notion-to-hugo.md` - `FORMATTING.md` - `CLAUDE.md`

Frequently asked questions

Hugo Notion Publish

File contents

Hugo Notion Publish

Overview

Workflow

Target locations

Publishing with Hugo CLI

Notion MCP helpers

Formatting rules

Quality checks

Resources

Related skills

Frequently asked questions

How do I install the Hugo Notion Publish skill?

What does the Hugo Notion Publish skill do?

Is Hugo Notion Publish safe to use?

Which AI agents work with Hugo Notion Publish?

Is Hugo Notion Publish free to use?

Who published Hugo Notion Publish?