skills.rest
ohmyhotelco
ohmyhotelcoOFFICIAL
Explore all skills by this author →
GitHub

pp-sync-notion

Sync finalized specification documents to Notion pages across multiple languages.

1|Updated Feb 19, 2026
Search Tags:#documentation#publishing#specification#mcp#notion#sync#multilingual
One-click install
npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill pp-sync-notion-ohmyhotelco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pp-sync-notion
Source: https://github.com/ohmyhotelco/hare-cc-plugins/tree/main/planning-plugin/skills/pp-sync-notion
Command: npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill pp-sync-notion-ohmyhotelco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping Notion documentation in sync with finalized specifications is tedious and error-prone when done manually, especially across multiple languages. This Skill automates publishing or re-syncing spec documents to Notion after finalization or manual edits. ## Core Features & Use Cases - Multi-language sync: Publishes spec files for the working language plus all target languages (en, ko, vi), or a single language via the --lang flag. - Structured page hierarchy: Creates or updates a parent Notion page with child pages for Overview, Screens, and Test Scenarios per language. - Progress-aware updates: Reads the feature's progress file to detect existing Notion pages (legacy or current format) and updates them instead of duplicating. - Use Case: After finalizing a hotel booking feature spec in English, Korean, and Vietnamese, run the sync once to publish all three language versions to the configured Notion parent page. ## Quick Start Ask the assistant to sync the specification for your feature to Notion, for example by saying: sync the checkout-flow spec to Notion in Korean only.

Frequently Asked Questions about pp-sync-notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a specification to Notion from Claude Code?▼

Run the sync command with the feature name, for example /planning-plugin:pp-sync-notion checkout-flow. The skill reads your project config, loads the spec files, and creates or updates Notion pages for each available language.

How do I sync only one language version of a spec to Notion?▼

Pass the --lang flag with the language code, such as --lang=ko for Korean. Without the flag, the skill syncs the working language plus every target language that has a spec directory.

What setup is required before syncing specs to Notion?▼

You need a .claude/planning-plugin.json config with a notionParentPageUrl, created by running pp-init. You also need the Notion MCP server configured and authenticated via OAuth in Claude Code.

Does syncing to Notion create duplicate pages if run twice?▼

No. The skill reads existing page URLs from the feature's progress file and updates those pages instead of creating duplicates. It detects both legacy and current page formats stored in the progress data.

Why does Notion sync fail with a configuration error?▼

Sync fails if the planning plugin config file is missing, the Notion parent page URL is empty, or the Notion MCP tool is unavailable. Run pp-init to set the parent page URL and verify the notion server appears in /mcp.

Related Skills

Explore More Product & Management Skills→
tamago0224tamago0224

mkdocs-translations

Translate MkDocs documentation into a target language and update mkdocs.yml for i18n.

Community
Intermediate
bnfergusonbnferguson

explain-diff-notion

Creates a Notion page explaining a code change with background, intuition, diagrams, and quiz questions.

Community
Intermediate
ChatCut-IncChatCut-Inc
836

video-translation

Translates and dubs speech in existing videos with voice preservation and optional lip-sync.

Official
Advanced
BoboeggBoboegg

generate-prd

Generate product requirements documents and publish them to Confluence, Notion, or HackMD.

Community
Advanced