Skip to main content
plugin

archetypal-alchemy — Claude Code plugin: what it does, how to install

archetypal-alchemy transforms Jungian archetypes and Major Arcana symbolism into UI layouts, design tokens, and Tailwind color palettes inside Claude Code.

MIT ★ 126 updated 2026-10-04

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code
/plugin install archetypal-alchemy@libreuiux
Open on GitHub

What archetypal-alchemy does

The plugin pairs 12 Jungian archetypes with 22 Major Arcana cards to produce design systems. Archetypes define layout structures, interaction patterns, and component shapes. Tarot cards supply color tokens and emotional tone. A Hero plus Sun pairing, for instance, yields bold, angular cards rendered in solar gold tones.

Inside the package live three Markdown skill guides, two slash commands, and the @archetypal-alchemist specialist agent. You call /archetypal-ui with a formula to construct specific elements like modal dialogues or blog layouts. Running /archetypal-colors pulls the palette tied to a chosen card. The agent can also audit existing screens and suggest pairings based on the product goal.

Because the plugin targets Tailwind CSS palettes, projects without Tailwind require manual translation of the generated color tokens.

What it helps with

  • generate UI components grounded in Jungian behavioral archetypes
  • extract Tarot-inspired color palettes for Tailwind CSS
  • receive archetypal design recommendations from a specialist agent
  • build layout structures and token sets for specific product moods

Example prompts for the agent

  • /archetypal-ui Hero+Sun for pricing cards
  • /archetypal-colors Sun
  • @archetypal-alchemist recommend archetypes for meditation app

How to install archetypal-alchemy

Plugin marketplace

/plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code
/plugin install archetypal-alchemy@libreuiux

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about archetypal-alchemy

How do I install archetypal-alchemy in Claude Code?

Add the marketplace source by running /plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code. Then install the package with /plugin install archetypal-alchemy@libreuiux.

What does archetypal-alchemy do?

It synthesizes 12 Jungian archetypes and 22 Major Arcana cards to generate UI components, spacing rules, and color palettes. Commands deliver structured interface blocks alongside design rationale.

What is the design formula behind the plugin?

The tool pairs an archetype for structure with an arcana card for color and mood. For example, Sage plus Hermit defines a clean, contemplative blog layout built for deep reading.

Source text

archetypal-alchemy · MIT
# Archetypal Alchemy Plugin

> Transform UI/UX design through the fusion of Jungian psychology and Tarot symbolism.

**Archetypal Alchemy** combines:
- **12 Jungian Archetypes** → Behavioral patterns, UI structures, interaction models
- **22 Major Arcana Cards** → Color palettes, atmospheric moods, symbolic energy

**Result**: Design systems with psychological depth and symbolic coherence.

---

## Quick Start

### Generate Components
```
/archetypal-ui Hero+Sun for pricing cards
/archetypal-ui Magician+Moon for modal
/archetypal-ui Sage+Hermit for blog layout
```

### Extract Color Palettes
```
/archetypal-colors Sun
/archetypal-colors Moon
/archetypal-colors Star
```

### Use the Agent
```
@archetypal-alchemist analyze my design
@archetypal-alchemist recommend archetypes for meditation app
```

---

## The Formula

```
ARCHETYPE + CARD = Complete Design System

Example:
Hero + Sun = Bold achievement in radiant golden tones
         ↓           ↓                    ↓
    Structure   Meaning              Colors
```

---

## The 12 Archetypes

| Archetype | Core Drive | Visual Language | Best For |
|-----------|------------|-----------------|----------|
| **Hero** | Mastery, achievement | Bold, angular, dynamic | Fitness, productivity, competitive |
| **Magician** | Transformation | Mysterious, gradient-rich | Mystical services, transformation tools |
| **Sage** | Truth, wisdom | Clean, minimal, scholarly | Education, knowledge platforms |
| **Innocent** | Safety, happiness | Soft, rounded, pastel | Wellness, children's products |
| **Explorer** | Discovery | Open, expansive | Travel, discovery platforms |
| **Rebel** | Disruption | Asymmetric, edgy | Disruptive startups |
| **Lover** | Intimacy, beauty | Elegant, sensual | Romance, beauty, luxury |
| **Creator** | Innovation | Artistic, experimental | Creative tools, maker platforms |
| **Jester** | Joy, playfulness | Colorful, bouncy | Entertainment, games |
| **Caregiver** | Service, nurturing | Warm, supportive | Healthcare, support services |
| **Ruler** | Control, leadership | Authoritative, structured | Business, premium tools |
| **Everyman** | Belonging | Familiar, approachable | Community, social platforms |

📖 **Full details**: [`skills/jungian-archetypes/SKILL.md`](skills/jungian-archetypes/SKILL.md)

---

## The 22 Major Arcana

| Card | Energy | Primary Color | Mood | Best For |
|------|--------|---------------|------|----------|
| **0. Fool** | New beginnings | Sky Blue | Optimistic, airy | Onboarding, fresh starts |
| **I. Magician** | Transformation | Deep Purple | Mysterious, powerful | Mystical, transformative |
| **II. High Priestess** | Intuition | Moonlight Blue | Serene, mysterious | Contemplative, spiritual |
| **III. Empress** | Abundance | Forest Green | Lush, nurturing | Growth, wellness |
| **IV. Emperor** | Authority | Imperial Red | Strong, commanding | Business, leadership |
| **V. Hierophant** | Tradition | Sacred Blue | Wise, traditional | Education, institutions |
| **VI. Lovers** | Union | Passionate Pink | Romantic, harmonious | Romance, connection |
| **VII. Chariot** | Victory | Victory Gold | Dynamic, triumphant | Achievement, momentum |
| **VIII. Strength** | Courage | Gentle Gold | Warm, powerful | Empowerment, fitness |
| **IX. Hermit** | Solitude | Deep Indigo | Contemplative, introspective | Meditation, reflection |
| **X. Wheel of Fortune** | Change | Cosmic Purple | Dynamic, cyclical | Dynamic platforms |
| **XI. Justice** | Balance | Balance Blue | Clear, authoritative | Legal, fairness-focused |
| **XII. Hanged Man** | Surrender | Inverted Teal | Suspended, serene | Perspective-shifting |
| **XIII. Death** | Transformation | Obsidian Black | Transformative, liminal | Major changes, resets |
| **XIV. Temperance** | Balance | Angelic Blue | Harmonious, alchemical | Wellness, balance |
| **XV. Devil** | Shadow | Infernal Red | Intense, seductive | Shadow work, intensity |
| **XVI. Tower** | Upheaval | Lightning White | Shocking, dramatic | Disruptive, revelatory |
| **XVII. Star** | Hope | Starlight Blue | Hopeful, serene | Aspirational, inspiring |
| **XVIII. Moon** | Illusion | Moonlight Silver | Mysterious, dreamlike | Dreams, unconscious |
| **XIX. Sun** | Joy | Solar Gold | Joyful, vibrant | Success, celebration |
| **XX. Judgement** | Rebirth | Angelic White | Awakening, clarity | Transformation, calling |
| **XXI. World** | Completion | Cosmic Violet | Celebratory, whole | Completion, achievement |

📖 **Full details**: [`skills/major-arcana/SKILL.md`](skills/major-arcana/SKILL.md)

---

## Popular Combinations

### For Achievement Platforms
- **Hero+Sun**: Victorious, radiant achievement
- **Hero+Chariot**: Forward momentum, unstoppable
- **Hero+Strength**: Gentle power, compassionate achievement

### For Mystical/Spiritual
- **Magician+Moon**: Transformative mystery
- **High Priestess+Hermit**: Deep intuitive wisdom
- **Sage+Star**: Hopeful knowledge

### For Wellness/Care
- **Caregiver+Empress**: Nurturing abundance
- **Caregiver+Temperance**: Balanced support
- **Innocent+Star**: Pure optimism

### For Disruptive Brands
- **Rebel+Tower**: Revolutionary shock
- **Rebel+Death**: Transformative disruption
- **Explorer+Wheel**: Adventurous change

### For Creative Tools
- **Creator+Magician**: Artistic transformation
- **Creator+Sun**: Joyful making
- **Jester+Fool**: Playful spontaneity

📖 **Full matrix**: [`skills/archetypal-combinations/SKILL.md`](skills/archetypal-combinations/SKILL.md)

---

## Plugin Structure

```
archetypal-alchemy/
├── README.md                           # This file
│
├── skills/                             # Knowledge base
│   ├── jungian-archetypes/
│   │   └── SKILL.md                    # 12 archetypes → UI patterns
│   ├── major-arcana/
│   │   └── SKILL.md                    # 22 cards → color palettes
│   └── archetypal-combinations/
│       └── SKILL.md                    # Synthesis engine
│
├── commands/                           # Slash commands
│   ├── archetypal-ui.md                # Generate components
│   └── archetypal-colors.md            # Extract palettes
│
└── agents/                             # Specialist agents
    └── archetypal-alchemist.md         # Master synthesizer
```

---

## Usage Examples

### Example 1: Pricing Page
```
User: /archetypal-ui Hero+Sun for pricing cards

Claude generates:
- Pricing cards with Hero structure (bold, competitive, achievement-focused)
- Sun palette applied (golden, radiant, victorious)
- Archetypal reasoning for each design choice
- Variations (Hero+Chariot, Hero+Strength)
```

**Result**: Pricing page that frames purchasing as victorious achievement.

### Example 2: Meditation App
```
User: Design a meditation app - introspective and mysterious feel

@archetypal-alchemist recommends:
- Archetype: Hermit (solitude, inner journey)
- Card: Moon (mysterious, dreamlike)
- Combination: Hermit+Moon

Generates:
- Complete design system
- Color tokens, typography, spacing
- Component library structure
- Archetypal rationale throughout
```

**Result**: App that feels like a contemplative sanctuary for inner exploration.

### Example 3: Color Palette Only
```
User: /archetypal-colors Tower

Claude provides:
- Lightning White, Storm Gray, Thunder Yellow, Rubble Black
- Complete Tailwind config
- Gradient formulas
- Shadow styles
- Usage guidelines
- Compatible archetypes (Rebel, Magician)
```

**Result**: Production-ready palette for shocking, disruptive designs.

---

## When to Use This Plugin

### Perfect For:
- ✅ Branding projects needing archetypal foundation
- ✅ UI redesigns lacking coherent personality
- ✅ Color palettes with emotional/psychological goals
- ✅ Design systems requiring depth and meaning
- ✅ Projects exploring mystical/spiritual themes
- ✅ Anything benefiting from symbolic resonance

### Not Ideal For:
- ❌ Pure utility tools (calculators, dashboards) - unless you want to add meaning
- ❌ Projects requiring generic, neutral aesthetics
- ❌ Rapid prototyping without brand consideration

---

## Philosophy

> "Every interface is a ritual space. Every interaction is a symbolic gesture."

### Core Principles

1. **Coherence over novelty** - Every choice reinforces the archetype
2. **Meaning over aesthetics** - Beautiful because it's true to its essence
3. **Depth over surface** - Patterns that resonate unconsciously
4. **Practicality with poetry** - Mystical wisdom meets production code

### Why This Works

**Jungian Archetypes** are universal patterns that users recognize unconsciously:
- Hero = mastery and achievement
- Sage = wisdom and learning
- Innocent = safety and simplicity

**Tarot Major Arcana** carries centuries of symbolic color associations:
- Sun = golden, joyful, victorious
- Moon = silver, mysterious, dreamlike
- Tower = shocking, lightning, disruptive

**Combined**: You get design systems that feel meaningful because they tap into deep psychological patterns.

---

## Advanced Techniques

### Multi-Archetype Blending
```
Hero (60%) + Sage (40%) + Sun
→ Bold achievement + knowledge organization, solar radiance
→ Educational platform celebrating mastery
```

### Archetypal Journey
```
Homepage: Innocent+Star (hopeful entry)
Product: Creator+Magician (transformative tool)
Pricing: Hero+Sun (victorious achievement)
```

### Paradoxical Combinations
```
Rebel+Hierophant = Disrupting tradition
Innocent+Devil = Naivety meets shadow
Ruler+Fool = Authority embraces chaos
```

---

## Contributing

Found a powerful new combination? Discovered a refinement to an archetype mapping? Share your archetypal insights!

**Ways to contribute**:
- Document successful combinations in real projects
- Refine archetype → UI pattern mappings
- Expand card → color palette variations
- Create example implementations
- Add cultural/mythological depth to archetypes

---

## Resources

### Further Study
- **Jungian Psychology**: *Man and His Symbols* - Carl Jung
- **Tarot Symbolism**: *The Tarot* - Paul Foster Case
- **Design Psychology**: *Emotional Design* - Don Norman
- **Archetypal Branding**: *The Hero and the Outlaw* - Margaret Mark & Carol Pearson

### Related Plugins
- **design-mastery** - Timeless design principles and masters
- **modern-uiux** - Contemporary component patterns
- **accessibility-first** - Ensure archetypal designs remain inclusive

---

## License

Part of the LibreUIUX project - MIT License

---

*"In the marriage of archetype and card, form finds its color, and color finds its purpose."*

✨ **Begin your alchemical work**: `/archetypal-ui Hero+Sun for hero section`

© Diego Bodart · MIT · Ormus-Solutions/LibreUIUX-Claude-Code

Similar plugins

All plugins for Design →

From the same set42

The whole set →
smart-fix smart-fix — a Claude Code command that orchestrates multiple specialized agents to analyze and resolve production incidents. CX Codex +1 ★ 126repo stars libreuiux-hooks libreuiux-hooks adds three Claude Code hooks to detect your UI stack at session start, protect secrets from silent edits, and flag accessibility issues right after UI changes. ★ 126repo stars vibe-coding The vibe-coding skill helps create throwaway UI prototypes, compare design directions, and decide when a concept is ready for production work. Use it while validating interface ideas or user flows. ★ 126repo stars mcp-integrations mcp-integrations is a Claude Code plugin that uses MCP browser tools to inspect live interfaces. It can turn screenshots into UI code and extract design tokens. ★ 126repo stars design-mastery design-mastery is a Claude Code plugin that applies established design principles to UI work. It supports layout analysis, design audits, style guides, and brand identity tasks. ★ 126repo stars julia-development julia-development adds julia-pro sub-agent that writes Julia 1.10+ code, optimizes numerical algorithms, designs multiple dispatch type hierarchies, and builds packages. ★ 126repo stars python-development Plugin for Python development: skills for asyncio, pytest, packaging and uv, an expert sub-agent, and a command to scaffold projects. ★ 126repo stars cloud-infrastructure cloud-infrastructure designs AWS, GCP, and Azure setups, prepares reusable Terraform modules, and optimizes cloud spending using six specialized subagents. ★ 126repo stars

Project sponsors

Companies that keep this analytics open