design-briefing

Creates UI/UX design briefs before frontend story implementation across multiple repositories.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/gmolike/Claude-Template --skill design-briefing-gmolike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-briefing
Source: https://github.com/gmolike/Claude-Template/tree/main/.claude/skills/design-briefing
Command: npx skills add https://github.com/gmolike/Claude-Template --skill design-briefing-gmolike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Frontend stories often get implemented without a clear design specification, causing inconsistent screens, missed states, and divergent UI patterns across multiple frontend repositories. This Skill produces a structured design brief before any UI story is implemented. ## Core Features & Use Cases - Structured Brief Template: Generates a complete design brief covering context, screens, data sources, interactions, states (empty/loading/error/success), design tokens, components, accessibility, and responsive behavior. - Cross-Repo Consistency: Enforces shared UI patterns (such as the Picker rule) across the lore-admin, session-gm, and session-player frontends. - Design Token Governance: Checks whether existing design tokens suffice or new ones are needed, with justification for cross-repo additions. - Use Case: Before implementing STORY-042 (a new encounter picker screen), the designer profile runs this Skill to write a brief in .scrum/repos/<repo>/designs/STORY-042-brief.md, referencing existing tokens and flagging the new <EncounterPicker> component spec. ## Quick Start Ask the designer profile to create a design brief for a specific story, for example: create a design brief for STORY-042 before implementing the encounter picker screen.

Frequently Asked Questions about design-briefing

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

FAQPage Schema
How do I write a design brief before implementing a frontend story?

Read the story file from the scrum backlog, identify the target screens, then fill in the brief template covering context, screens, design tokens, components, accessibility, and responsive behavior. Save the result in the repo's designs directory or directly in the story file.

What should a UI design brief template include?

A complete brief includes the user problem and linked use case, screen layouts with data sources and interactions, all UI states (empty, loading, error, success), design tokens, component reuse versus new components, accessibility requirements, and responsive breakpoints.

How do I keep UI consistent across multiple frontend repositories?

Reference shared design tokens from each repo's design-tokens rules file and document cross-frontend pattern equivalents in the brief. The Picker rule, for example, requires a visible create-new option even with a single item, and must match across lore-admin, session-gm, and session-player.

When should new design tokens be introduced?

Only when existing tokens from the repo's design-tokens reference cannot cover the new screen's needs. The brief must state which repo receives the new token, whether it applies cross-repo, and a short justification.

What accessibility requirements belong in a design brief?

Specify keyboard navigation and tab order, ARIA labels and landmarks for screen readers, WCAG AA color contrast (4.5:1 normal, 3:1 large text), and reduced-motion handling via the prefers-reduced-motion media query.