gk-design-brief

Creates Grovekeeper UI component briefs and triggers /gk-mockup for visuals.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/MartinoPolo/Grovekeeper --skill gk-design-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gk-design-brief
Source: https://github.com/MartinoPolo/Grovekeeper/tree/main/.agents/skills/gk-design-brief
Command: npx skills add https://github.com/MartinoPolo/Grovekeeper --skill gk-design-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It speeds up building consistent Grovekeeper UI documentation by turning vague requests into structured, container-correct design briefs with required elements, states, and adoption guidance.

Core Features & Use Cases

  • Component inventory & format alignment: Uses the repository’s existing design system and prior briefs to match Grovekeeper’s established structure.
  • Container-context correctness: Forces the brief author to identify whether the component is tab content, session content, modal content, standalone, or embedded so chrome duplication is avoided.
  • Storybook-driven coverage & adoption suggestions: Inventories available UI components and recommends missing primitives by checking shadcn-svelte and Bits UI when needed.
  • Next-step visual generation: After saving, triggers /gk-mockup to produce visual variants for the new brief.

Quick Start

Use gk-design-brief with the target component name provided after the prompt keyword, then save the generated brief into designs/<component-name>/DESIGN_BRIEF_<COMPONENT_NAME>.md to proceed to mockup generation.

Frequently Asked Questions about gk-design-brief

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

FAQPage Schema
How do I create a design brief for UI components that matches an existing design system?

A component design brief needs required UI elements, interactive states, container-context identification (tab, modal, or standalone), and adoption guidance to prevent chrome duplication and ensure design system consistency.

How do I generate UI mockups after finalizing a component design spec?

You can check available Storybook component variants and inventory existing shadcn-svelte and Bits UI primitives to identify missing UI elements and recommend adoption suggestions for your brief.

Why does my UI component spec duplicate container chrome during design?

Container chrome duplication occurs when the container context is undefined; the brief forces authors to identify whether the component is tab, session, modal, standalone, or embedded to avoid this issue.

Can I use Storybook variants to build a state-complete component spec?

Yes, the Skill inventories available Storybook component variants alongside your existing design system to ensure the generated component spec is container-correct and state-complete.