One-click install
npx skills add https://github.com/ThorStarlord/interface-skills --skill ui-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-brief
Source: https://github.com/ThorStarlord/interface-skills/tree/main/scratch/claude-install-test/ui-brief
Command: npx skills add https://github.com/ThorStarlord/interface-skills --skill ui-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ui-brief helps teams stop mismatched expectations by converting vague UI intent into a precise, constraint-based product and design brief that downstream work can trace back to.

Core Features & Use Cases

  • Pre-flight requirement gathering: Collects answers for primary user, primary action, success criteria, constraints, and non-goals, asking when information is missing instead of inventing defaults.
  • Spec Recovery with Observed vs. Target: Reconstructs missing intent from an existing UI by clearly separating what the current UI does (Observed) from what it should do (Target), with explicit gaps.
  • Strict, validation-oriented output template: Produces a brief.md that follows the required template sections and enforces acceptance criteria such as measurable success criteria and explicit assumptions/open questions.

Quick Start

Use ui-brief to create a structured brief by telling the AI: "I want to build a settings page for our team chat app where admins manage members; web only; users are IT admins at mid-sized companies—draft the UI brief and ask any open questions."

Frequently Asked Questions about ui-brief

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

FAQPage Schema
How do I turn vague UI ideas into a structured product brief with testable acceptance criteria?

To turn vague UI ideas into a structured product brief, you provide initial design intent and target users. The system then asks clarifying questions to fill gaps and outputs a brief.md with measurable success criteria, constraints, and non-goals.

What is the best way to recover missing UI specifications for an existing screen?

Spec recovery for an existing UI involves separating what the current interface does (Observed) from what it should do (Target). This process reconstructs missing design intent and highlights explicit gaps without inventing new decisions.

How do I document interaction design assumptions and open questions instead of guessing requirements?

Documenting interaction design assumptions requires a validation-oriented template that records open questions and assumptions explicitly. This prevents mismatched expectations by ensuring downstream work traces back to recorded constraints rather than invented defaults.

Can I generate a UI specification for a new feature if I only have a basic description of the primary user action?

Yes, generating a UI specification from a basic description triggers pre-flight requirement gathering. The system collects missing information about primary actions, success criteria, and constraints by asking questions instead of assuming default behaviors.

Does the product brief output template enforce measurable success criteria and non-goals?

The product brief output template strictly enforces measurable success criteria and explicit non-goals. It follows a validation-oriented structure to ensure all constraint-based specifications are testable and traceable for downstream interface work.