CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/tui-snapshot-tester

Use when a terminal UI (TUI) app needs tests that catch layout regressions. Captures rendered terminal frames as SVG or text snapshots and diffs them on each run: pytest-textual-snapshot for Textual, insta for Ratatui, teatest for Bubble Tea, ink-testing-library for Ink.

Quality

87%

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

Overview
Quality
Evals
Security
Files

Quality

Content

81%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.

The content is a well-sequenced, highly actionable guide covering four TUI ecosystems with executable code, an explicit human-review checkpoint before baseline updates, and a useful anti-patterns checklist. It is lean overall, with only minor redundancy in the overview/repeated source attributions and slightly incomplete code snippets (missing imports in the Rust/Go/TypeScript examples).

DimensionReasoningScore

Conciseness

The body is efficient — steps, code, an anti-patterns table, and limitations with little conceptual padding — but has minor trimmable redundancy: the "Per [txt][txt]" framing is repeated ~8 times, and the Overview's 4-step snapshot cycle restates the Step 2 workflow. Not the 5-anchor's "every token earns its place", but clearly above the midpoint.

4 / 5

Actionability

Mostly executable guidance: pip install command, verbatim snap_compare tests with press/terminal_size/run_before variants, a complete CI YAML job, and working examples for Rust, Go, and Ink including baseline-update commands. The Rust snippet omits imports and references placeholder functions (draw_main, app_state) and the Go/TypeScript snippets omit imports, so it falls just short of fully copy-paste ready.

4 / 5

Workflow Clarity

Steps 1-9 are clearly sequenced with an explicit validation checkpoint and feedback loop in Step 2 (run pytest, open the HTML report, review left/right renders, only accept via --snapshot-update if correct, commit), reinforced by the determinism step and the anti-patterns table acting as a checklist. The baseline-update operation is semi-destructive and its validation (human review before update) is explicitly present, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well-structured with numbered steps, an anti-patterns table, and a References section of one-level external links. The four per-framework guides (~15-25 lines each) are compact enough to justify inlining, though splitting them into references/ files would marginally improve token efficiency for users targeting one framework.

4 / 5

Total

17

/

20

Passed

Description

87%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 leads with an explicit "Use when" trigger, states concrete capture-and-diff actions, and enumerates the four ecosystem-specific tools. Only minor improvements are possible — a broader action verb list and a couple of extra synonyms (screenshot, visual regression) would make it airtight.

DimensionReasoningScore

Specificity

Concrete actions are stated ("Captures rendered terminal frames as SVG or text snapshots and diffs them on each run") and the description maps four named tools to their frameworks ("pytest-textual-snapshot for Textual, insta for Ratatui, teatest for Bubble Tea, ink-testing-library for Ink"), but the action list itself is only two verbs (capture, diff) rather than the comprehensive multi-action coverage of the top anchor.

4 / 5

Completeness

Both parts are explicit: the what ("Captures rendered terminal frames as SVG or text snapshots and diffs them on each run" with per-framework tooling) and a leading explicit when-clause ("Use when a terminal UI (TUI) app needs tests that catch layout regressions") with a concrete trigger condition, matching the both-what-and-when anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "terminal UI (TUI) app", "tests", "layout regressions", "snapshots", and all four framework names (Textual, Ratatui, Bubble Tea, Ink) are terms users would actually say. A few natural variations are missing, e.g. "screenshot testing" or "visual regression", keeping it below the comprehensive-synonym level.

4 / 5

Distinctiveness Conflict Risk

The TUI snapshot-testing niche is clearly delimited by named frameworks and the layout-regression trigger, so it would not naturally fire for generic testing, CLI-output, or browser-screenshot skills; conflict risk is minimal.

5 / 5

Total

18

/

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.

Reviewed

On this page