CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recording

Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures. Probe capabilities before recording.

Quality

85%

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

92%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 an exemplary lean operational skill: exact tool names, parameters, platform truths, and error-recovery loops with zero padding. The only notable gap is the absence of a concrete example invocation (e.g. a full `recording_start` call or a `screenshot` → `zoom` chain) covering the common case end-to-end.

DimensionReasoningScore

Conciseness

Every sentence carries non-obvious operational detail — permission ownership ("the Codewhale Computer Use app when `request_access` says `via: \"app\"`, else the terminal"), platform unavailability ("installing ffmpeg does not enable it"), and raster-ID lifecycle rules — with no explanation of concepts Claude already knows. The body is lean and every token earns its place.

5 / 5

Actionability

Guidance names exact tools with their parameters (`recording_start` with `display`, `region`, `fps`, `durationSec`, `intervalMs`; `screenshot` returning `raster_id` feeding `zoom`) and error tokens (`raster_stale`, `no_raster`) with recovery actions. It falls short of anchor 5 only because no literal example invocation or payload is shown for the common case, leaving a minor gap.

4 / 5

Workflow Clarity

The five-step sequence (pick computer → check `request_access` → start → work → `recording_stop` → list/status) is explicit, with validation checkpoints ("Check `request_access` when readiness is unknown") and error-recovery feedback loops ("On `raster_stale` or `no_raster`, observe again; never drop the ID to retry"; denial → "tell the user which, do not retry"). Capture operations are non-destructive, so no batch-validation cap applies.

5 / 5

Progressive Disclosure

The body is 33 lines with no bundle files and no need for external references; it is organized into a clear workflow section, platform truths, and a screenshot-semantics section, fitting the simple-skill exception for scoring 5. Navigation within the short single file is unambiguous, so it does not sit between anchors 4 and 5.

5 / 5

Total

19

/

20

Passed

Description

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

The description is specific, lean, and covers the skill's capabilities concretely, with a clear operational scope. Its main weakness is the absence of any "Use when..." trigger clause, which both caps completeness and leaves invocation guidance implicit, and a few natural trigger terms (screen recording, video) are missing.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to record the screen, take or manage screenshots, or review saved captures on a registered computer."

Include natural trigger variations users would actually say, such as "screen recording", "video capture", or "screencast", to strengthen keyword coverage.

Clarify the scope boundary versus a plain screenshot tool — e.g. noting it manages the full capture lifecycle (start, stop, list, status) — to reduce overlap risk with generic screenshot skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Capture screenshots on registered computers", "record on macOS or HarmonyOS", "manage saved captures", "Probe capabilities before recording" — covering the skill's full capability range with no padding. This matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor coverage gaps, but screenshots, recording, capture management, and capability probing are all named.

5 / 5

Completeness

The "what" is explicit and concrete, but there is no "Use when..." clause or equivalent trigger guidance; "Probe capabilities before recording" is operational instruction, not a statement of when to invoke the skill. Per the judging guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms like "screenshots", "record", "captures", "macOS", and "HarmonyOS" are present, but common user phrasings such as "screen recording", "video", "screen capture", and file extensions like ".mov" are missing. Good keyword coverage with a few natural terms absent fits anchor 4; anchor 5 would require synonyms and extensions.

4 / 5

Distinctiveness Conflict Risk

"Registered computers", "macOS or HarmonyOS", and "saved captures" carve a fairly distinct niche with platform-specific anchors, but the generic screenshot capability could overlap a general screenshot tool. Mostly distinct with minor overlap risk fits anchor 4; the niche is clear enough to sit above anchor 3.

4 / 5

Total

16

/

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

Hmbown/Codewhale

Path

crates/tui/plugins/computer-use/skills/recording/SKILL.md

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.