CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

yao-job

Background job management — start, monitor, wait, stop long-running commands. ALWAYS invoke this skill when the user asks to run background tasks, check job status, read job output, or manage long-running commands.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent reference-style skill body: lean, fully actionable tool documentation with concrete rules and a clear receipt-handling loop. The main gaps are a consolidated start-to-finish lifecycle sequence and headroom to split detailed parameter/response reference if the tool surface grows.

Suggestions

Add one short consolidated lifecycle sequence (start with background=true → yao_job_wait or poll yao_job_output → handle BackgroundJobReceipt) so the multi-step workflow is explicit rather than assembled from Usage Rules.

If the tool surface or parameter details grow, move the full parameter tables and response-field lists into a references/ file, keeping SKILL.md as a tools-plus-rules overview.

DimensionReasoningScore

Conciseness

The body is dense reference material — parameter tables with defaults, response-field lists, error codes, and usage rules — with no explanation of concepts Claude already knows and no padding; even the 20 MB ring-buffer worked example is contract-critical information. Every token earns its place, matching the lean-and-efficient anchor.

5 / 5

Actionability

Every tool is fully executable guidance: exact parameter names, required flags, defaults, JSON response shapes for each call pattern, error codes, and concrete rules like "Use background true (not bare --background) for commands expected to run longer than 30 seconds". This covers the common cases copy-paste ready, per the fully-executable anchor.

5 / 5

Workflow Clarity

Usage Rules and the numbered BackgroundJobReceipt procedure provide sequence and an explicit validation/error-recovery checkpoint ("If status=failed, investigate and take corrective action"), but the full background-job lifecycle (start → wait/monitor → handle receipt) must be assembled across two sections rather than presented as one sequenced workflow, and some checkpoints are implicit. This fits 'clear sequence with most checkpoints present; minor validation gaps' better than the explicit-checklist anchor at 5.

4 / 5

Progressive Disclosure

A single well-sectioned file (Tools, Parameters, Response Fields, Errors, Usage Rules, BackgroundJobReceipt) with no nested or dangling references and appropriate inlining for a six-tool surface. It misses the 5 anchor because at 119 lines roughly half the body is parameter/response reference that could eventually live in a separate reference file — a minor organization gap, not the misplacement described by the 3 anchor.

4 / 5

Total

18

/

20

Passed

Description

88%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: concrete action verbs, explicit what-and-when structure, and natural trigger phrases. The only improvements are broader synonym coverage and sharper delineation from generic command-execution skills.

Suggestions

Add common user synonyms to the trigger clause, e.g. "start/stop a background process", "kill a running command", or "check if a command is still running".

Sharpen distinctiveness from generic shell-execution skills by anchoring triggers on job-specific nouns ("job", "job status", "job output") rather than the broadly applicable "run background tasks".

DimensionReasoningScore

Specificity

"Background job management — start, monitor, wait, stop long-running commands" lists four concrete actions, and the trigger clause adds "check job status, read job output", covering the full tool surface (start, list/get, output, wait, stop). This matches the comprehensive-coverage anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

It explicitly answers both questions: the what ("start, monitor, wait, stop long-running commands") and the when ("ALWAYS invoke this skill when the user asks to run background tasks, check job status, read job output, or manage long-running commands") with concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Natural phrases like "run background tasks", "check job status", "read job output", and "manage long-running commands" are exactly what users would say, but common synonyms are missing (e.g. "background process", "kill/stop a process", "is it still running", "tail the output"). Good coverage with a few natural terms missing fits the 4 anchor; it is not comprehensive enough for 5.

4 / 5

Distinctiveness Conflict Risk

The background/long-running job niche with job-status/output triggers is mostly distinct, but "run background tasks" carries minor overlap risk with closely related generic shell/command-execution skills, fitting the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict anchor.

4 / 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.

Repository

YaoApp/yao

Path

tools/skills/yao-job/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.