Use when you need to communicate with the human visually through the terminal. Examples: "show a status panel", "display an overlay notification", "build a visual dashboard in the terminal".
58
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/visual-feedback/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a clear 'Use when' clause with good trigger examples and covers both what and when effectively. Its main weakness is that the core capability description is somewhat vague—'communicate with the human visually through the terminal' doesn't specify concrete actions like rendering boxes, color formatting, or ASCII art. The distinctiveness could also be improved by specifying the exact technology or approach used.
Suggestions
Add more specific concrete actions to the description, e.g., 'Renders styled boxes, progress bars, tables, and color-formatted text in the terminal using ANSI escape codes' or similar specifics.
Sharpen distinctiveness by specifying the rendering approach or library used, to differentiate from general terminal output or TUI framework skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain (visual terminal communication) and gives some examples of actions (status panel, overlay notification, visual dashboard), but doesn't list concrete capabilities like specific rendering techniques, supported elements, or formatting options. | 2 / 3 |
Completeness | Explicitly answers both 'what' (communicate with the human visually through the terminal) and 'when' (the 'Use when' clause with concrete examples of triggering scenarios). The 'Use when' clause is present and provides clear trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would actually say: 'status panel', 'display an overlay notification', 'build a visual dashboard in the terminal', 'terminal'. These cover common variations of how users would request visual terminal output. | 3 / 3 |
Distinctiveness Conflict Risk | The focus on visual terminal output is somewhat distinctive, but 'communicate with the human visually through the terminal' could overlap with general terminal output skills, TUI frameworks, or dashboard-building skills. The niche is moderately clear but not sharply defined. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured domain guide for wsh visual feedback that covers overlays and panels comprehensively with good design guidance and practical patterns. Its main weaknesses are: examples use a descriptive pseudocode notation rather than executable commands (actionability gap), the document is somewhat long for a single file with no supporting references, and it lacks explicit validation/verification steps in its workflows. The content is genuinely useful and domain-specific, but could be tighter and more actionable.
Suggestions
Add explicit validation steps to workflows — e.g., after creating an overlay, read the screen to verify it rendered at the expected position, and include a concrete example of this verify-then-adjust loop.
Make examples more actionable by showing actual tool calls or curl commands alongside the pseudocode notation, or at minimum clarify the mapping between the descriptive syntax and the actual wsh_* tool parameters.
Consider splitting composition patterns and pitfalls into a separate reference file (e.g., PATTERNS.md) to reduce the main skill's length and improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long (~300 lines) and includes some content Claude could infer (e.g., explaining what x/y coordinates mean, that (0,0) is top-left). However, most content is domain-specific guidance about wsh overlays/panels that Claude wouldn't inherently know, and the design patterns are genuinely useful. Some sections like 'Visual Structure: Borders and Padding' could be tightened since box-drawing is a well-known technique. | 2 / 3 |
Actionability | The skill provides many concrete examples with JSON span structures and pseudocode-like descriptions of operations (e.g., 'create panel (bottom, height: 2)'), but these are not fully executable — they use a descriptive notation rather than actual API calls or tool invocations. The execution context preamble explicitly defers API details elsewhere, which means the skill intentionally avoids copy-paste-ready commands, leaving a gap in actionability. | 2 / 3 |
Workflow Clarity | The skill covers lifecycle management (create → update → delete), cleanup patterns, and pitfalls like stale elements and coordinate drift. However, there are no explicit validation checkpoints or feedback loops — for example, no step saying 'verify the overlay rendered correctly by reading the screen' or 'check screen dimensions before positioning.' The lifecycle section mentions tracking IDs but doesn't provide a clear sequential workflow with verification steps. | 2 / 3 |
Progressive Disclosure | The content is well-organized with clear section headers and a logical progression from concepts → design patterns → composition → pitfalls. However, it's a monolithic document with no references to supporting files. Given its length (~300 lines), some sections like composition patterns or the full pitfalls guide could be split into separate reference files. The execution context preamble references 'skills/core/SKILL.md' for API details, which is good progressive disclosure for the API layer. | 2 / 3 |
Total | 8 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
4863aaf
Table of Contents
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.