gaming-ui-state-management — Claude Code skill for game UI
gaming-ui-state-management is a skill for building game-style health, mana, and XP indicators with visuals that respond to changing values.
MIT 2 installs ★ 2,083 updated 2026-10-26
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a claude-codeWhat gaming-ui-state-management does
The skill shows how to build health, mana, and XP bars on top of the Progress component, with distinct colors and a retro variant. At XP value 100, its example displays a level-up message; conditional classes also change the visual treatment as health drops. An enemy display calculates current health as a percentage of its maximum.
The examples cover React components, conditional animation classes, and a compact enemy-health display. They use the .retro class for pixel-style text and assign different colors to game metrics. The snippets import @/components/ui/8bit/progress and use cn, so those project components and the helper need to be available.
Reference implementations are named health-bar.tsx, xp-bar.tsx, and mana-bar.tsx. The approach extends Progress rather than replacing it with a separate progress component.
What it helps with
- Render health, mana, and XP as distinct bars
- Show a level-up message when the XP bar reaches
100 - Change the health indicator as its value falls
- Display an enemy's current and maximum health
Example prompts for the agent
- Build retro health, mana, and XP bars using
Progress. - Add a level-up message when the XP value reaches
100. - Create a compact enemy health display with current and maximum values.
How to install gaming-ui-state-management
1Skills CLI (Vercel)
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a claude-code2Manually: put the files in place
~/.claude/skills/gaming-ui-state-management/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gaming-ui-state-management/
1Skills CLI (Vercel)
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a codex2Manually: put the files in place
.agents/skills/gaming-ui-state-management/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a cursor2Manually: put the files in place
.cursor/skills/gaming-ui-state-management/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TheOrcDev/8bitcn-ui .claude/skills/gaming-ui-state-management2Manually: put the files in place
.github/skills/gaming-ui-state-management/SKILL.md1Skills CLI (Vercel)
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a gemini-cli2Platform CLI
gemini skills install https://github.com/TheOrcDev/8bitcn-ui --path .claude/skills/gaming-ui-state-managementManually: put the files in place
.devin/skills/gaming-ui-state-management/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -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 gaming-ui-state-management
How do I install gaming-ui-state-management in Claude Code?
Run npx skills add TheOrcDev/8bitcn-ui --skill gaming-ui-state-management -a claude-code. The skill file is available at ~/.claude/skills/gaming-ui-state-management/SKILL.md.
What does gaming-ui-state-management do?
It provides patterns for game-style health, mana, and XP bars, plus state-based animations and a level-up message.
How does the skill build game progress bars?
It extends the Progress component with game-specific colors and styling. The enemy-health example derives a percentage from current and maximum health.
Source text
SKILL.md · MIT
---
name: gaming-ui-state-management
description: Patterns for game-like interfaces - health bars, XP bars, mana bars. Apply when building RPG/retro gaming UI components with state-driven visuals.
---
## Gaming UI State Management
Create game-like interfaces with state-driven visuals for health, XP, mana, and other game metrics.
### Progress Bar Pattern
Build on the Progress component with game-specific variants:
```tsx
import { Progress } from "@/components/ui/8bit/progress";
function HealthBar({ value = 100, ...props }: BitProgressProps) {
return (
<Progress
{...props}
value={value}
variant="retro"
progressBg="bg-red-500"
/>
);
}
function ManaBar({ value = 100, ...props }: BitProgressProps) {
return (
<Progress
{...props}
value={value}
variant="retro"
progressBg="bg-blue-500"
/>
);
}
function XpBar({ value = 0, ...props }: BitProgressProps) {
return (
<Progress
{...props}
value={value}
variant="retro"
progressBg="bg-yellow-500"
/>
);
}
```
### Level Up Notification
Show animated messages when thresholds are reached:
```tsx
function XpBar({
value,
levelUpMessage = "LEVEL UP!",
...props
}: XpBarProps) {
const isLevelUp = value === 100;
return (
<div className="relative">
<Progress
{...props}
value={value}
progressBg="bg-yellow-500"
className={cn(isLevelUp && "animate-pulse")}
/>
{isLevelUp && (
<div
className={cn(
"retro",
"absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2",
"text-[0.625rem] text-black",
"pointer-events-none whitespace-nowrap z-10",
"drop-shadow-[1px_1px_0_#fff] [text-shadow:1px_1px_0_#fff,-1px_-1px_0_#fff,1px_-1px_0_#fff,-1px_1px_0_#fff]",
"animate-[blink_0.5s_step-end_infinite]"
)}
>
{levelUpMessage}
</div>
)}
</div>
);
}
```
### Conditional Animations
Use conditional classes for game state feedback:
```tsx
<div
className={cn(
"transition-colors duration-300",
health <= 25 ? "animate-pulse bg-red-500/20" : "bg-green-500",
health > 25 && health <= 50 && "bg-yellow-500/20"
)}
/>
```
### Enemy Health Display
Compact display for combat scenarios:
```tsx
function EnemyHealth({ health, maxHealth }: EnemyHealthProps) {
const percentage = (health / maxHealth) * 100;
return (
<div className="retro text-xs">
<div className="flex justify-between mb-1">
<span>ENEMY</span>
<span>{health}/{maxHealth}</span>
</div>
<HealthBar value={percentage} className="h-2" />
</div>
);
}
```
### Key Principles
1. **Base component** - Extend Progress, don't reimplement
2. **Color coding** - Red (health), Blue (mana), Yellow (XP), Green (stamina)
3. **Retro text** - Use `.retro` class for pixel font numbers
4. **State animations** - Use `animate-pulse`, `animate-blink` for feedback
5. **Text shadows** - White text-shadow for legibility on colored backgrounds
6. **Compact sizing** - Smaller text (text-xs, text-[0.625rem]) for game UIs
### Reference Components
- `components/ui/8bit/health-bar.tsx` - Health bar implementation
- `components/ui/8bit/xp-bar.tsx` - XP bar with level up notification
- `components/ui/8bit/mana-bar.tsx` - Mana bar implementation
© TheOrcDev · MIT · TheOrcDev/8bitcn-ui