synthesize-patterns

Synthesizes cross-repo engineering patterns from analyze-patterns learnings files into universal principles and trade-off analyses.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/muselesscreator/ui-skills --skill synthesize-patterns-muselesscreator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesize-patterns
Source: https://github.com/muselesscreator/ui-skills/tree/main/synthesize-patterns
Command: npx skills add https://github.com/muselesscreator/ui-skills --skill synthesize-patterns-muselesscreator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running pattern analysis on multiple repositories, learnings sit scattered across per-repo files with no way to see which patterns recur universally, which conflict, and which are worth generalizing across codebases. ## Core Features & Use Cases - Cross-Repo Synthesis: Reads all patterns.md learnings files from ~/.claude/repo-learnings/ and identifies universal patterns, convergent solutions, complementary pairs, and conflicting trade-offs. - Meta-Principle Distillation: Derives 4-8 overarching engineering principles with concrete examples and consequences of violation. - Persistent Output: Writes the full synthesis to ~/.claude/cross-repo-learnings/synthesis.md with an index for ongoing reference. - Use Case: After analyzing five OSS repos with /analyze-patterns, run this Skill to discover that compound components and thin handlers appear everywhere, while mock isolation strategies genuinely conflict — and get guidance on when each applies. ## Quick Start Ask the AI to synthesize patterns across all repos, optionally filtering by repo name or pattern area such as testing.

Frequently Asked Questions about synthesize-patterns

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

FAQPage Schema
How do I synthesize patterns across multiple repositories?

Run the synthesize-patterns skill after generating per-repo learnings with analyze-patterns. It reads every patterns.md file in ~/.claude/repo-learnings/, compares patterns across repos, and writes a unified synthesis to ~/.claude/cross-repo-learnings/synthesis.md.

What is the difference between analyze-patterns and synthesize-patterns?

analyze-patterns examines a single repository and produces that repo's patterns.md learnings file. synthesize-patterns runs afterward across all repos, comparing those files to find universal patterns, conflicts, and overarching principles.

Can I filter synthesis to specific repos or pattern areas?

Yes. Pass arguments like repo names or area filters (e.g. focus on testing) when invoking the skill. Without arguments, it interactively asks which repos and areas to include before proceeding.

Why is my work repo excluded from the synthesis?

Work repos whose source has a ./wiki/ directory contain code-specific learnings destined for that repo's wiki, not repo-agnostic knowledge. The skill excludes them by design so the personal layer holds zero code-specific facts, and flags the exclusion in the scope summary.

What happens if no patterns.md files exist yet?

The skill stops and tells you to run /analyze-patterns in each repo first. Synthesis requires at least one existing learnings file under ~/.claude/repo-learnings/ to compare.