dedalus-labs/wingman / .agents/skills/better-interface
better-interface
VerifiedDesign engineering principles for making TUI interfaces feel polished. Use when building Textual widgets, reviewing TUI code, implementing transitions, focus states, alignment, spacing, or any visual detail work. Triggers on TUI polish, design details, "make it feel better", "feels off", layout alignment, color consistency, responsive sizing.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.0 KB |
| color.md | markdown | 1.9 KB |
| interaction.md | markdown | 2.6 KB |
| layout.md | markdown | 1.5 KB |
| typography.md | markdown | 2.7 KB |
color.md
View on GitHub# Color
Palette consistency, contrast, and semantic color usage in terminal UIs.
## Color Hierarchy
Use 3-4 tiers. Every color in the palette belongs to exactly one tier.
| Tier | Purpose | Example (Tokyo Night) |
| --- | --- | --- |
| Primary | Key actions, active focus, links | `#7aa2f7` (blue) |
| Secondary | Labels, metadata, inactive tabs | `#565f89` (dim) |
| Muted | Borders, separators, background accents | `#3b4261` (very dim) |
| Semantic | Success, error, warning — state only | `#9ece6a`, `#f7768e`, `#e0af68` |
### Rules
- Never use semantic colors for decoration. Red means error. Green means success.
- Body text uses the default foreground — don't override it unless it's a label.
- Background colors should have enough contrast with text (4.5:1 minimum for
accessibility, though terminal users typically tolerate lower).
## Consistency
Pick colors from one palette. Mixing hex values from different themes
creates visual noise.
```python
# Good — centralized palette
class Colors:
PRIMARY = "#7aa2f7"
DIM = "#565f89"
BORDER = "#3b4261"
ERROR = "#f7768e"
SUCCESS = "#9ece6a"
# Bad — ad-hoc hex values scattered across widgets
label.styles.color = "#6699ff" # close to primary but not quite
border.styles.color = "#444444" # doesn't match the palette
```
## Dark-on-Dark Contrast
Terminal UIs are almost always dark mode. Common mistakes:
- Borders that are invisible against the background (too close in value)
- Dim text that disappears on some terminal themes
- Bright white text that causes eye strain
Test with at least two terminal themes (one dark, one light-on-dark)
to catch contrast issues.
## Focus Color
The focused widget gets the primary color on its border or background.
Everything else stays muted. This creates an immediate visual hierarchy
without any animation.
```tcss
Widget:focus {
border: tall $primary;
}
Widget {
border: tall $muted;
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |