plan-sync

Sync .spec directory progress to Notion pages on demand.

9|1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/mark22013333/crew --skill plan-sync-mark22013333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-sync
Source: https://github.com/mark22013333/crew/tree/main/plugins/feature-workflow/skills/plan-sync
Command: npx skills add https://github.com/mark22013333/crew --skill plan-sync-mark22013333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically push the current progress of .spec/{slug}/ directories to Notion on demand, enabling quick visibility for reviews and sharing status with teammates.

Core Features & Use Cases

  • On-demand plan-sync: sync all active task files from .spec to Notion.
  • Partial sync: sync only spec.md, db.md, or arch.md (as supported).
  • Notion-page management: create or update Notion pages and synchronize status fields.

Quick Start

Run /plan-sync to push the current .spec progress to Notion.

Frequently Asked Questions about plan-sync

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

FAQPage Schema
How do I sync .spec directory progress to Notion?

You can sync .spec directory progress to Notion on demand by running the /plan-sync command, which pushes plan artifacts like spec.md, db.md, and arch.md directly to a configured Notion page.

What is the best way to share project spec status with teammates?

Sharing project spec status is best handled by on-demand synchronization to Notion, which automatically updates page properties and plan artifacts so teammates can review progress before milestones.

Can I selectively sync only db.md and arch.md files to Notion?

Yes, you can selectively sync individual plan artifacts like db.md, arch.md, or spec.md to Notion, allowing partial syncs instead of pushing the entire .spec directory at once.

Do I need a configured Notion integration to sync plan artifacts?

Yes, a configured Notion integration is required to update Notion pages and synchronize status fields, ensuring the plan-sync operations can successfully push your .spec progress.

When should I use on-demand plan synchronization for project management?

On-demand plan synchronization should be used when you are close to project milestones or before sharing status updates with teammates, providing immediate visibility into your current spec progress.

What limitations exist when updating Notion pages with spec progress?

Limitations include requiring access to the specific .spec/{slug} layout and a pre-configured Notion integration, as the sync cannot update pages without proper access to manage Notion page properties.