CtrlK
BlogDocsLog inGet started
Tessl Logo

tui-design

Use this skill when designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard AND mouse navigation, building terminal dashboards, or working with any TUI framework. Activates on mentions of TUI design, terminal UI, Ratatui layout, Ink components, Textual widgets, Bubbletea views, terminal color palette, keybinding design, panel layout, split panes, terminal dashboard, box-drawing characters, sparklines, progress bars, modal dialogs, focus management, mouse support, clickable terminal UI, or terminal accessibility. Always consult this skill when a TUI is being built or restyled, even if the user only asks for it to "look modern" or "feel clickable" — mouse interaction and visual polish are core to this skill, not an afterthought.

72

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, expert-level design reference that trusts the reader and delivers unusually concrete decisions (specific glyphs, color policy, failure modes, and a real verification matrix). Its weaknesses are mild: recurring mouse guidance across sections, embedded date stamps, and a body long enough that some reference-grade tables belong in the already well-organized references/ bundle.

Suggestions

Consolidate the mouse-interaction guidance that currently spans the 'Make It Feel Modern and Clickable' table, the 'Mouse navigation'/'Mouse capture' rows in 'Input, Focus, and Editing', and two Anti-Patterns rows into a single section with short cross-references.

Move the two 'Checked 2026-09-04' date stamps into the existing 'Primary Sources' section (or a single maintenance note) so time-sensitive information is isolated from the durable guidance.

Consider relocating the Terminal Capability Policy table and the verification test matrix into a references/ file, keeping SKILL.md to the layout, interaction, and state guidance that every invocation needs.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no space is spent explaining what a TUI is or how frameworks work — but the '2026-09-04' date stamps appear twice outside any deprecated/old-patterns section, and mouse-interaction guidance recurs across 'Make It Feel Modern and Clickable', 'Input, Focus, and Editing', and two Anti-Patterns rows. These minor instances could be trimmed, matching the 'efficient; minor instances of over-explanation' anchor rather than the fully lean anchor above it.

4 / 5

Actionability

For an instruction-only design skill the guidance is fully actionable: 'prefer rounded box-drawing corners (╭ ╮ ╰ ╯) over square (┌ ┐ └ ┘)', 'one cell of padding inside panels', 'Do not mix EventStream with read/poll', 'WCAG's 4.5:1 normal-text contrast', '80x24 is a useful test case', plus a concrete test matrix and named reference apps (lazygit, k9s, yazi). Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific, and it is not below the anchor since common cases are covered.

5 / 5

Workflow Clarity

The sections form a coherent progression — 'Choose the Layout from the Work' → interaction/inputs → 'State and Async Work' → capability policy → accessibility → rendering/lifecycle → 'Verification That Changes Confidence' — with concrete validation checkpoints ('inspect at least one real PTY session', 'verify the shell cursor and echo behavior are restored'). It is a design-concern reference rather than a sequenced build procedure, so it sits at 'clear sequence with most checkpoints present' rather than the fully explicit step/feedback-loop anchor.

4 / 5

Progressive Disclosure

References are well-signaled and one level deep — 'Read [app-patterns.md](references/app-patterns.md) for examples and tradeoffs' and 'Read [visual-catalog.md](references/visual-catalog.md) when selecting glyphs' — and both files exist. However, the 176-line body inlines reference-grade material (full Terminal Capability Policy, verification matrix, anti-pattern tables) that could live in references/, so it matches 'good structure; most content appropriately placed; minor organization gaps' rather than the ideal clear-overview split.

4 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it explicitly states what the skill does, gives unusually rich natural-language and framework-level triggers, and includes multiple explicit when-clauses including a proactive consultation rule. The only weakness is that a few chart-flavored triggers (dashboards, sparklines, progress bars) are not qualified as TUI-specific, creating minor overlap risk with visualization skills.

DimensionReasoningScore

Specificity

It lists multiple concrete capabilities — 'designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard AND mouse navigation, building terminal dashboards' — comprehensively covering the skill's domain with no vague filler, matching the 'lists multiple specific concrete actions; comprehensive coverage' anchor. It is not the 4-anchor because there is no meaningful coverage gap.

5 / 5

Completeness

Both halves are explicit: what ('designing terminal user interfaces... building terminal dashboards, or working with any TUI framework') and when ('Use this skill when...', 'Activates on mentions of...', 'Always consult this skill when a TUI is being built or restyled, even if the user only asks for it to "look modern"'). This matches the anchor for clearly answering both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and natural, spanning the whole domain and its synonyms: 'TUI design, terminal UI, Ratatui layout, Ink components, Textual widgets, Bubbletea views, terminal color palette, keybinding design, panel layout, split panes, terminal dashboard, box-drawing characters, sparklines, progress bars, modal dialogs, focus management, mouse support'. Named frameworks give the synonym coverage the 5-anchor requires.

5 / 5

Distinctiveness Conflict Risk

The TUI niche is distinct and framework-named triggers are unambiguous, but 'terminal dashboards', 'sparklines', and 'progress bars' as bare activation terms carry minor overlap risk with charting/dataviz skills, fitting 'mostly distinct; minor overlap risk with closely related skills'. It is not 5 because those triggers are not scoped to a TUI context, and not 3 because the overlap is confined to adjacent visualization skills rather than many similar skills.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
administrakt0r/pro-skills-repo-administraktor
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.