sync-design-system

Synchronize design-system documents with session decisions on tokens, color, typography, and UX patterns.

41|4|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/etr/groundwork --skill sync-design-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-design-system
Source: https://github.com/etr/groundwork/tree/main/skills/sync-design-system
Command: npx skills add https://github.com/etr/groundwork --skill sync-design-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps design-system decisions and guidelines aligned across sessions and documents, preventing drift and rework.

Core Features & Use Cases

  • Sync tokens, typography, color, and UX patterns after design sessions.
  • Generate and update a centralized design-system document that teams can reference during implementation.
  • Maintain an audit trail of changes with contextual notes and timestamps.

Quick Start

Run this skill at session end to update the design-system document with decisions made during the session.

Frequently Asked Questions about sync-design-system

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

FAQPage Schema
How do I keep design tokens and typography decisions synced across documentation?

To keep design tokens and typography synced across documentation, you can apply session decisions to centralized design-system files, ensuring updates reflect consistently across single-file and directory-based workloads while preserving existing content.

What is the best way to prevent design-system drift between sessions?

Preventing design-system drift between sessions involves applying an audit trail with contextual notes and timestamps to track changes, keeping design decisions aligned and preventing rework across subsequent implementation phases.

Can I update a directory-based design system structure without losing existing content?

Yes, you can update directory-based design system structures without losing existing content; the synchronization process preserves prior information while applying new color, UX pattern, and token updates consistently across formats.

When do I need to synchronize design-system documents?

You need to synchronize design-system documents at the end of a design session to capture decisions made during that period, ensuring the centralized reference remains current for implementation teams.

Does design system synchronization work with both single-file and directory-based formats?

Yes, design system synchronization works with both single-file design_system.md and directory-based design_system/ workloads, applying token, color, typography, and UX pattern updates consistently across both structural formats.

What is included in a design-system audit trail for tracking changes?

A design-system audit trail includes contextual notes and timestamps for tracking changes, providing a historical record that documents when and why token, color, typography, and UX pattern decisions were updated.