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 |
layout.md
View on GitHub# Layout
Alignment, spacing, and responsive sizing for terminal UIs.
## Spacing Scale
Use consistent cell-based spacing: 0, 1, 2, 4. Textual CSS `padding`
and `margin` are in cell units (not pixels).
```tcss
/* Good — consistent spacing */
#sidebar {
padding: 1 2;
margin: 0 1;
}
#content {
padding: 1 2;
}
/* Bad — arbitrary spacing */
#sidebar {
padding: 1 3;
margin: 0 2;
}
#content {
padding: 2 1;
}
```
## Responsive Sizing
TUI must work at 80x24 minimum. Use fractional units and min/max
constraints.
```tcss
/* Good — adapts to terminal width */
#sidebar {
width: 1fr;
min-width: 20;
max-width: 40;
}
#main {
width: 3fr;
}
/* Bad — fixed width breaks on small terminals */
#sidebar {
width: 30;
}
```
## Content Regions
Split the screen into clear regions: header, content, footer. The
content region gets all remaining space via `1fr`. Header and footer
are fixed height.
```tcss
Screen {
layout: vertical;
}
#header {
height: 1;
dock: top;
}
#footer {
height: 1;
dock: bottom;
}
#content {
height: 1fr;
}
```
## Alignment
- Left-align labels and values in forms
- Right-align numeric columns in tables
- Center titles only when the container is narrow (< 40 cols)
- Use `content-align: center middle` for empty states and loading screens
## Overflow
Content that doesn't fit must degrade gracefully:
- Truncate long strings with ellipsis via `overflow: hidden`
- Scroll vertically in content regions, never horizontally
- Collapse optional columns in tables when terminal is narrow
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 |