sync-project

Synchronize project progress and status to Notion pages via the Notion API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/JYHTHEGREAT/jyh-system --skill sync-project-jyhthegreat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-project
Source: https://github.com/JYHTHEGREAT/jyh-system/tree/main/archive/reusable/common/skills/sync-project
Command: npx skills add https://github.com/JYHTHEGREAT/jyh-system --skill sync-project-jyhthegreat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Project stakeholders often need up‑to‑date status information in both client‑facing and internal Notion pages, and manually keeping these pages synchronized with Git and planning documents is time‑consuming and error‑prone.

Core Features & Use Cases

  • Dual Notion page sync: Updates a client‑visible page and an internal page from a single source.
  • Automatic data extraction: Parses prompt_plan.md for phase progress, aggregates Git logs, and incorporates session‑captured notes.
  • Configurable operation: Supports flags like --check-only, --force, and --skip-notion for preview, forced updates, or data‑only runs.
  • Use case example: A development team runs the skill after each sprint to push progress, risks, and client requests to Notion without manual editing.

Quick Start

Invoke the /sync-project command in the project root to synchronize the Notion pages with the current project status.

Frequently Asked Questions about sync-project

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

FAQPage Schema
How do I automatically sync project progress from Git to a Notion dashboard?

To automatically sync project progress to a Notion dashboard, you need a tool that parses planning documents and aggregates Git logs into formatted markdown. This Skill automates that process by extracting phase progress and session notes, then writing them directly to client-facing and internal Notion pages via the API.

Can I update both client-facing and internal Notion pages from a single prompt_plan.md file?

Yes, you can update both client-facing and internal Notion pages from a single source. The Skill parses your prompt_plan.md frontmatter and body, aggregates the Git version history, and writes formatted markdown sections to multiple specified Notion pages simultaneously.

How do I preview project status updates before writing them to Notion?

To preview project status updates before writing to Notion, run the synchronization command with the --check-only flag. This allows you to review the extracted prompt_plan.md data and aggregated Git logs without pushing any changes to the Notion API.

Does this project synchronization tool work without an active Git repository?

No, this project synchronization tool requires a Git repository to function correctly. It specifically aggregates Git logs and reads accumulated session data to compile project status, meaning Git version history is a necessary dependency for generating accurate Notion dashboard updates.

What is the best way to automate sprint status reporting to Notion for software projects?

The best way to automate sprint status reporting to Notion is using a tool that reads prompt_plan.md and Git logs to generate dashboards. This Skill extracts phase progress and session-captured notes, pushing formatted updates to Notion pages after each sprint without manual editing.

Why are my Notion pages not updating when I run the project sync command?

If your Notion pages are not updating during project sync, you may need to use the --force flag to override stale data checks. Alternatively, you can run with --skip-notion to verify that prompt_plan.md parsing and Git log aggregation are completing successfully before attempting the API write.