design-button-hierarchy

Map primary, secondary, and tertiary actions to distinct button visual treatments.

240|11|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill design-button-hierarchy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-button-hierarchy
Source: https://github.com/gnurio/refactoring-ui-plugin/tree/main/skills/05-design-button-hierarchy
Command: npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill design-button-hierarchy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires 03-build-color-palette, establish-visual-hierarchy.

What problem does it solve?

Poor button hierarchies make users unsure which action to take, increase mistakes, and reduce the clarity of key calls to action.

Core Features & Use Cases

  • Primary/Secondary/Tertiary Mapping: Assign visual weight so primary actions stand out while secondary and tertiary actions remain clearly subordinate.
  • Corrective Evaluation & Redesign Suggestions: Detect failure modes like “button battle,” ambiguous gray styling, and destructive actions competing with primary.
  • Context-Aware Application: Apply the hierarchy appropriately across screens and components such as modals, forms, pages, and toolbars.

Quick Start

Use the skill to evaluate a modal or form’s action buttons and return updated styling rules for primary, secondary, and tertiary states.

Frequently Asked Questions about design-button-hierarchy

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

FAQPage Schema
How do I fix unclear button hierarchy in a modal or form?

Fix unclear button hierarchy by mapping primary, secondary, and tertiary actions to distinct visual treatments, ensuring a single dominant primary CTA stands out while subordinate actions remain clearly differentiated to pass UI design reviews.

What is a button battle and how does it affect UI design?

A button battle occurs when multiple actions compete for visual dominance, confusing users. Button hierarchy resolves this by enforcing a single primary action with subordinate secondary and tertiary styling, reducing user mistakes and clarifying calls to action.

How do I style destructive and disabled buttons to maintain visual hierarchy?

Style destructive and disabled buttons by applying explicit differentiation from standard actions, ensuring destructive actions do not compete with the primary CTA while maintaining clear accessibility contrast across all button states in your UI design.

Can I apply button hierarchy rules across pages and toolbars, not just modals?

Yes, you can apply button hierarchy contextually across pages, forms, modals, and toolbars. The system scales the primary, secondary, and tertiary visual treatments to fit each component while keeping action importance reliably communicated.

When do I need to establish visual hierarchy for my primary CTA?

Establish visual hierarchy for your primary CTA when users are unsure which action to take or when ambiguous gray styling causes errors. It is required whenever a screen has multiple actions competing for attention without clear dominance.