OpenParable
Skip to content
← Back to skills

Design Synthesis

Design
design-synthesis

Design 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 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)