gsd-ui-phase — Claude Code skill: what it does, how to install
The gsd-ui-phase skill for Claude Code generates the UI-SPEC.md design contract for frontend phases. Runs during frontend UI development.
MIT 584 installs ★ 11,761 updated 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a claude-codeWhat gsd-ui-phase does
The skill creates a frontend design contract by orchestrating UI research and verification subagents. The workflow covers validation, UI research, and specification verification. It relies on workflow and brand reference files located at ~/.claude/gsd-core/workflows/ui-phase.md and ~/.claude/gsd-core/references/ui-brand.md.
The tool auto-detects the next unplanned phase if no argument is passed, or accepts a specific phase number. It executes end-to-end while preserving all workflow gates.
What it helps with
- create a frontend design contract
- generate the UI-SPEC.md specification
- validate frontend phase requirements
- orchestrate UI research and verification
Example prompts for the agent
- Run the gsd-ui-phase skill for the current phase
- Generate UI-SPEC.md for phase 3 using gsd-ui-phase
- Create a UI design contract
How to install gsd-ui-phase
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a claude-code2Manually: put the files in place
~/.claude/skills/gsd-ui-phase/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gsd-ui-phase/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a codex2Manually: put the files in place
.agents/skills/gsd-ui-phase/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a cursor2Manually: put the files in place
.cursor/skills/gsd-ui-phase/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-ui-phase2Manually: put the files in place
.github/skills/gsd-ui-phase/SKILL.md1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a gemini-cli2Platform CLI
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-ui-phaseManually: put the files in place
.devin/skills/gsd-ui-phase/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gsd-ui-phase
How to install gsd-ui-phase in Claude Code?
Run npx skills add open-gsd/gsd-core --skill gsd-ui-phase -a claude-code and use the file ~/.claude/skills/gsd-ui-phase/SKILL.md.
What does gsd-ui-phase do?
It builds a UI design contract (UI-SPEC.md) for frontend phases by coordinating research and verification workflows.
How does phase detection work?
If you omit the phase argument, the skill automatically detects the next unplanned phase in your project.
Source text
SKILL.md · MIT
--- name: gsd-ui-phase description: "Generate UI design contract (UI-SPEC.md) for frontend phases" argument-hint: "[phase]" allowed-tools: - Read - Write - Bash - Glob - Grep - Agent - WebFetch - AskUserQuestion - mcp__context7__* --- <arguments>$ARGUMENTS</arguments> The text inside `<arguments>` is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed. <objective> Create a UI design contract (UI-SPEC.md) for a frontend phase. Orchestrates gsd-ui-researcher and gsd-ui-checker. Flow: Validate → Research UI → Verify UI-SPEC → Done </objective> <execution_context> @~/.claude/gsd-core/workflows/ui-phase.md @~/.claude/gsd-core/references/ui-brand.md </execution_context> <context> Phase number: the `<arguments>` block — optional, auto-detects next unplanned phase if omitted. </context> <process> Execute end-to-end. Preserve all workflow gates. </process>
© open-gsd · MIT · open-gsd/gsd-core