How do I install the Design Synthesis skill?

Run npx skillmds add majiayu000/design-synthesis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Design Synthesis safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Design Synthesis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Design Synthesis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Design Synthesis?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Design Synthesis by majiayu000 — Agent Skill

Name: Design Synthesis
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

Design Synthesis

Use when user says "synthesize designs", "show design patterns", "UI patterns", "UX patterns", "update design docs", or asks about UI/UX design decisions - generates two markdown files summarizing UI/UX patterns from implemented stories and anti-patterns from rejected or problematic UI/UX stories.

majiayu000 604ccf7 2 files · 3.7 KB Updated Sep 9, 2026 567 repo stars

File contents

Design Synthesis Skill

Generate patterns.md and anti-patterns.md in .claude/data/design/.

Workflow

Step 1: Check Prerequisites

python .claude/scripts/design_synthesis_helpers.py prereq

Exit early if:

needs_patterns_update = false AND needs_anti_patterns_update = false (counts unchanged)
No relevant story data (ui_implemented_count = 0 AND ui_rejected_count = 0)

Step 2: Spawn Parallel Agents

Launch agents for files that need updating (haiku model):

Agent 1 (patterns) - Only if needs_patterns_update is true:

Query: python .claude/scripts/design_synthesis_helpers.py patterns
Read existing .claude/data/design/patterns.md for context (if exists)
Write .claude/data/design/patterns.md with sections:
- Design Philosophy - Core UI/UX principles guiding the project
- Component Patterns - Reusable UI component patterns
- Interaction Patterns - Standard user interaction flows
- Layout Conventions - Consistent layout approaches
- Accessibility Standards - A11y requirements and patterns
- Footer with timestamp

Agent 2 (anti-patterns) - Only if needs_anti_patterns_update is true:

Query: python .claude/scripts/design_synthesis_helpers.py anti-patterns
Read existing .claude/data/design/anti-patterns.md for context (if exists)
Write .claude/data/design/anti-patterns.md with sections:
- Rejected Approaches - UI/UX ideas explicitly rejected (with rejection reasons)
- Usability Issues - Known usability problems to avoid
- Visual Anti-Patterns - Visual design mistakes to avoid
- Interaction Anti-Patterns - Poor interaction patterns to avoid
- Performance Concerns - UI patterns that cause performance issues
- Footer with timestamp

Step 3: Update Metadata

After agents complete, update the synthesis metadata:

python .claude/scripts/design_synthesis_helpers.py update-meta

This records current counts so future prereq checks can skip synthesis when nothing has changed.

Key Rules

Spawn agents in parallel, never sequentially
Use Python sqlite3 module, NOT sqlite3 CLI
Include rejection reasons in anti-patterns bullets
Read existing files first to preserve accumulated context
Always run update-meta after successful synthesis
Focus on UI/UX-related stories (search for keywords: ui, ux, design, layout, component, button, form, modal, dialog, menu, navigation, style, theme, color, font, icon, responsive, accessibility, a11y)

---name: design-synthesisdescription: Use when user says "synthesize designs", "show design patterns", "UI patterns", "UX patterns", "update design docs", or asks about UI/UX design decisions - generates two markdown files summarizing UI/UX patterns from implemented stories and anti-patterns from rejected or problematic UI/UX stories.--- # Design Synthesis Skill Generate `patterns.md` and `anti-patterns.md` in `.claude/data/design/`. ## Workflow ### Step 1: Check Prerequisites ```bash python .claude/scripts/design_synthesis_helpers.py prereq ``` **Exit early if:** - `needs_patterns_update` = false AND `needs_anti_patterns_update` = false (counts unchanged) - No relevant story data (`ui_implemented_count` = 0 AND `ui_rejected_count` = 0) ### Step 2: Spawn Parallel Agents Launch agents for files that need updating (haiku model): **Agent 1 (patterns)** - Only if `needs_patterns_update` is true: - Query: `python .claude/scripts/design_synthesis_helpers.py patterns` - Read existing `.claude/data/design/patterns.md` for context (if exists) - Write `.claude/data/design/patterns.md` with sections: - **Design Philosophy** - Core UI/UX principles guiding the project - **Component Patterns** - Reusable UI component patterns - **Interaction Patterns** - Standard user interaction flows - **Layout Conventions** - Consistent layout approaches - **Accessibility Standards** - A11y requirements and patterns - Footer with timestamp **Agent 2 (anti-patterns)** - Only if `needs_anti_patterns_update` is true: - Query: `python .claude/scripts/design_synthesis_helpers.py anti-patterns` - Read existing `.claude/data/design/anti-patterns.md` for context (if exists) - Write `.claude/data/design/anti-patterns.md` with sections: - **Rejected Approaches** - UI/UX ideas explicitly rejected (with rejection reasons) - **Usability Issues** - Known usability problems to avoid - **Visual Anti-Patterns** - Visual design mistakes to avoid - **Interaction Anti-Patterns** - Poor interaction patterns to avoid - **Performance Concerns** - UI patterns that cause performance issues - Footer with timestamp ### Step 3: Update Metadata After agents complete, update the synthesis metadata: ```bash python .claude/scripts/design_synthesis_helpers.py update-meta ``` This records current counts so future prereq checks can skip synthesis when nothing has changed. ## Key Rules - Spawn agents in parallel, never sequentially - Use Python sqlite3 module, NOT sqlite3 CLI - Include rejection reasons in anti-patterns bullets - Read existing files first to preserve accumulated context - Always run update-meta after successful synthesis - Focus on UI/UX-related stories (search for keywords: ui, ux, design, layout, component, button, form, modal, dialog, menu, navigation, style, theme, color, font, icon, responsive, accessibility, a11y)

Frequently asked questions