structure-decide

Determine monolithic or composition structure for UI components from spec requirements.

2|5|Updated Oct 24, 2023
One-click install
npx skills add https://github.com/aziontech/webkit --skill structure-decide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structure-decide
Source: https://github.com/aziontech/webkit/tree/main/.claude/skills/structure-decide
Command: npx skills add https://github.com/aziontech/webkit --skill structure-decide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

structure-decide removes guesswork when deciding whether a UI component should be monolithic or composition-based, ensuring consistent alignment with the shadcn-vue criterion.

Core Features & Use Cases

  • Monolithic vs composition verdict: Produces a clear structure: monolithic or structure: composition outcome based on reordering/omission needs.
  • Spec-aware inputs: Uses the component spec’s Purpose, Props, Slots, and Sub-components, or the verbal description during spec creation, and optionally the figma-discover JSON to evaluate regions.
  • Defense-in-depth recheck: Supports initial decision during /spec-create and a second confirmation during /component-create when the spec is approved.
  • Strict decision output: Emits only the two required output lines (verdict + one-sentence rationale) or blocks with a targeted missing-section message.

Quick Start

Use the structure-decide skill to analyze a component spec and output whether its structure should be monolithic or composition along with a one-sentence rationale tied to consumer reordering/omission needs.

Frequently Asked Questions about structure-decide

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

FAQPage Schema
How do I decide between monolithic and composition component architecture?

Component architecture decisions rely on consumer reordering and omission requirements, evaluating whether a monolithic props and slots structure or a composition pattern better fits the spec. This approach aligns UI structure choices with shadcn-vue criteria.

When should I use composition over monolithic props for UI components?

Use composition over monolithic props when consumers need to reorder or omit sub-components within the UI structure. The structure-decide mechanism outputs a composition verdict specifically when these flexible reordering and omission needs are present in the component spec.

How do I validate component structure against a shadcn-vue spec?

Spec validation checks the component's Purpose, Props, Slots, and Sub-components sections against shadcn-vue criteria. If required spec sections are missing, the validation blocks processing and returns a targeted missing-section message instead of a structure verdict.

What is the best way to structure a shadcn-vue component spec?

Structuring a shadcn-vue component spec requires defining Purpose, Props, Slots, and Sub-components to evaluate monolithic versus composition patterns. Applying the structure decision during spec creation and re-checking it during component creation ensures spec validation consistency.

Can I use figma-discover JSON to determine component structure?

Yes, figma-discover JSON can optionally be provided to evaluate regions and determine whether a component design should use monolithic props and slots or a composition pattern based on consumer reordering and omission requirements.

Why does my component structure validation return a blocked message?

Component structure validation returns a blocked message when required spec sections such as Purpose, Props, Slots, or Sub-components are missing. The system only emits a valid structure verdict and one-sentence rationale when all mandatory spec inputs are present.