skills.rest
spencerbeggs
spencerbeggsCOMMUNITY
Explore all skills by this author →
GitHub

design-compare

Compare design documents across git history and generate structured diff reports.

Updated Jan 20, 2026
Search Tags:#git#design#reporting#diff#version-control
One-click install
npx skills add https://github.com/spencerbeggs/claude-design-coordinator --skill design-compare
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-compare
Source: https://github.com/spencerbeggs/claude-design-coordinator/tree/main/.claude/skills/design-compare
Command: npx skills add https://github.com/spencerbeggs/claude-design-coordinator --skill design-compare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comparing design documents across git history to understand evolution, ensure consistency, and track decisions over time.

Core Features & Use Cases

  • Version-aware comparisons: load document versions from different commits/refs and compute diffs.
  • Flexible formats: produce unified, side-by-side, semantic, or summary reports.
  • Insightful analysis: highlight frontmatter changes, structural shifts, and content edits; generate actionable insights for design reviews.
  • Use Case: Review a design doc's progression from feature kickoff to current state to understand decisions and trade-offs.

Quick Start

Run the design-compare command with a document and a reference to perform a versioned comparison.

Frequently Asked Questions about design-compare

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

FAQPage Schema
How do I compare design documents across different git commits?▼

Compare design documents across git history by loading document versions from different commits or branches and computing diffs. The process generates structured reports highlighting frontmatter changes, structural shifts, and content edits to track document evolution.

What is the best way to track design doc changes over git version history?▼

Tracking design doc changes over git history involves computing version-aware diffs between commits or branches. It produces structured reports with metrics and highlights to review revisions and understand document evolution and trade-offs.

Can I generate a side-by-side diff report for markdown design files in git?▼

Yes, you can generate side-by-side diff reports for design files in git. The workflow supports flexible formats including unified, side-by-side, semantic, or summary reports to highlight frontmatter changes and structural shifts.

Does the design comparison workflow validate frontmatter changes?▼

Yes, the design comparison workflow enforces frontmatter validation. It specifically highlights frontmatter changes alongside structural shifts and content edits to generate actionable insights for design reviews.

What formats are available for git design document diff reports?▼

Available formats for git design document diff reports include unified, side-by-side, semantic, and summary outputs. These flexible formats highlight structural shifts and content edits to support actionable design reviews.

Related Skills

Explore More Design & Creative Skills→
borkwebborkweb
7

writing-commits

Generate and format git commit messages using Conventional Commits standards.

Community
Intermediate
bingran-youbingran-you
3

data-report

Convert Xiaohongshu performance data into structured stakeholder reports.

Community
Advanced
AJBcodingAJBcoding
4

moai-cc-claude-md

Generate structured Markdown documentation with templates and cross-references.

Community
Advanced
WscatsWscats
31

who-is-actor

Analyze Git commit history to generate detailed developer profiles.

Community
Advanced