skills.rest
withpiper
withpiperOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sync-linear

Synchronize .vbw-planning files bidirectionally with the Linear workspace.

6|Updated Apr 8, 2026
Search Tags:#planning#roadmap#linear#issues#sync#vbw
One-click install
npx skills add https://github.com/withpiper/pipekit --skill sync-linear
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-linear
Source: https://github.com/withpiper/pipekit/tree/main/skills/sync-linear
Command: npx skills add https://github.com/withpiper/pipekit --skill sync-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bidirectional sync between VBW planning and Linear workspace to prevent drift and manual reconciliation.

Core Features & Use Cases

  • Bidirectional push-pull sync for ROADMAP, PLAN, and issues.
  • Conflict detection and user-driven resolution.
  • Promote-ready status recommendations for Project tracks.

Quick Start

Run /sync-linear to synchronize VBW planning with Linear and review conflicts.

Frequently Asked Questions about sync-linear

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

FAQPage Schema
How do I sync VBW planning files with Linear issues and roadmaps?▼

To sync VBW planning files with Linear, run /sync-linear to perform bidirectional synchronization of ROADMAP.md, STATE.md, and PLAN.md files with Linear issues. It detects conflicts and asks for user-driven resolution.

Can I push VBW project status updates directly to Linear?▼

Yes, you can promote VBW project status changes to Linear. The sync skill provides promote-ready status recommendations for Project tracks and saves updates via Linear APIs.

How does bidirectional Linear sync handle planning conflicts?▼

Bidirectional Linear sync detects planning conflicts during updates and pulls, then prompts for user-driven resolution to prevent drift across ROADMAP, PLAN, and issue states.

What files are required for VBW and Linear workspace synchronization?▼

VBW and Linear sync requires reading and writing to .vbw-planning/ROADMAP.md, .vbw-planning/STATE.md, .vbw-planning/phases/*/PLAN.md, and .vbw-planning/linear-map.json files.

Does the Linear sync skill support pulling issues from Linear into VBW?▼

Yes, the sync supports Linear→VBW pulls. It retrieves issue states using list_issues and get_project APIs to maintain alignment with your local VBW planning files.

What is the best way to prevent drift between VBW planning and Linear?▼

The best way to prevent drift is bidirectional push-pull sync. Run /sync-linear to automatically reconcile ROADMAP, PLAN, and issue states, eliminating manual reconciliation.

Related Skills

Explore More Product & Management Skills→
withpiperwithpiper
6

roadmap-create

Generate a staged ROADMAP.md from strategy docs and project-definition.md for Linear execution.

Official
Advanced
KirKruglovKirKruglov
5

monitor-progress

Generate sprint progress, deviation, and weekly status reports from Jira and planning data.

Community
Intermediate
usk6666usk6666
11

project

Synchronize roadmap documents with development issues in Linear.

Community
Advanced
secutils-devsecutils-dev
101

secutils-export-import

Export and import Secutils.dev workspace contents with selective modes.

Official
Advanced