atomic-design-planning

Guide UI component creation and organization using the Atomic Design methodology.

2|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/jclfocused/claude-agents --skill atomic-design-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atomic-design-planning
Source: https://github.com/jclfocused/claude-agents/tree/main/custom_plugins/plugins/linear-planning-workflow/skills/atomic-design-planning
Command: npx skills add https://github.com/jclfocused/claude-agents --skill atomic-design-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers and designers organize UI components using the Atomic Design methodology, promoting consistency, reusability, and a scalable frontend architecture. It guides decisions on when to create new components versus reusing existing ones.

Core Features & Use Cases

  • Atomic Design Guidance: Provides a clear hierarchy of Atoms, Molecules, Organisms, Templates, and Pages.
  • Reuse-First Principle: Emphasizes searching for and adapting existing components before creating new ones.
  • Decision Support: Offers a decision table and anti-pattern avoidance tips for component creation.
  • Use Case: When planning a new feature that requires a user profile card, this skill helps determine if existing Button, Avatar, and Text atoms can be combined into a new Molecule or Organism, or if a completely new component is truly necessary.

Quick Start

Use the atomic-design-planning skill to guide the creation of a new user profile card component.

Frequently Asked Questions about atomic-design-planning

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

FAQPage Schema
How do I organize UI components for better frontend architecture and reuse?

Apply the Atomic Design methodology to establish a clear hierarchy of Atoms, Molecules, Organisms, Templates, and Pages. This approach promotes component reuse, maintains design system consistency, and builds a scalable frontend architecture.

When should I create a new UI component versus reusing an existing one?

Follow a reuse-first principle by searching for and adapting existing components before creating new ones. Use the provided decision table to evaluate component reuse against organism complexity, determining if existing atoms can be combined into a new molecule or if a new component is truly necessary.

How do I plan a scalable user profile card using atomic design?

Plan a user profile card by evaluating if existing Button, Avatar, and Text atoms can be combined into a new Molecule or Organism. This technique ensures scalable and maintainable user interfaces by maximizing component reuse and avoiding unnecessary duplication.

What are common anti-patterns to avoid when building design systems?

Common design system anti-patterns include creating overly complex organisms or duplicating functionality instead of reusing existing atoms. The methodology provides anti-pattern avoidance tips to ensure component creation remains scalable, maintainable, and adheres to atomicity principles.

Does atomic design work for managing complex frontend architectures?

Atomic design is built for managing complex frontend architectures by enforcing atomicity and organism complexity limits. It facilitates architectural discussions and ensures your user interfaces remain scalable and maintainable as the component library expands.