Skills
.Work. You
Rest

component-spec-proposer

Official

Turn component issues into validated specs

Product & Management#accessibility#requirements#design system#github issues#storybook#project workflow#component spec
AuthorStack-and-Flow
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Converts vague component tasks plus a reference implementation into a clear, issue-backed, validation-ready specification that aligns with the design system’s rules and Storybook/accessibility conventions.

Core Features & Use Cases

  • Reference-driven spec proposals: Extracts behavior, states, accessibility, anatomy, and examples from the provided reference.
  • Design-system alignment: Adapts the proposal to Stack-and-Flow tokens, the required component structure, and contribution-phase expectations.
  • Validation-first workflow: Prevents premature GitHub updates by requiring explicit user approval before writing “Validated component spec” and changing Project status.
  • Project + issue coordination: Updates the issue first, then sets the corresponding GitHub Project item to “In progress” after approval.

Quick Start

Ask the skill to propose a component spec by providing the GitHub issue URL and a HeroUI (or other) reference URL, then respond with approve or list required edits.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: component-spec-proposer
Download link: https://github.com/Stack-and-Flow/design-system/archive/main.zip#component-spec-proposer

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.