Design Synthesis
Designdesign-synthesisDesign Synthesis is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/design/design-synthesis-mharbulous-syncopaid/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/design-synthesis, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 ANDneeds_anti_patterns_update= false (counts unchanged)- No relevant story data (
ui_implemented_count= 0 ANDui_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.mdfor context (if exists) - Write
.claude/data/design/patterns.mdwith 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.mdfor context (if exists) - Write
.claude/data/design/anti-patterns.mdwith 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)