CtrlK
BlogDocsLog inGet started
Tessl Logo

qzcli

Manage GPU compute jobs on the Qizhi (启智) platform using qzcli — a kubectl-style CLI tool. Use when user says "qzcli", "启智平台", "submit job", "stop job", "查计算组", "avail", "list jobs", "batch submit", or needs to manage distributed training jobs on a Qizhi instance.

66

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 highly actionable, executable CLI reference with clear sequencing and validation via dry-run previews. Its main weaknesses are the absence of post-submit/ pre-stop verification steps and the lack of any progressive disclosure — the full command reference lives inline in SKILL.md instead of being split into bundle reference files.

Suggestions

Split the per-command detail (parameter table, batch config format, HPC/Slurm section, troubleshooting rows) into a references/ file (e.g., references/commands.md), keeping SKILL.md as a concise overview with well-signaled one-level-deep links.

Add a post-submit verification step to the workflow (e.g., `qzcli status JOB_ID` or `qzcli watch` to confirm the job started and check logs for silent failures).

Deduplicate the Quick Start against the Authentication/Resource Discovery sections, and add a pre-stop check (confirm the job ID and state via `qzcli ls`/`qzcli status`) before the destructive `qzcli stop`.

DimensionReasoningScore

Conciseness

The body is dominated by compact, commented command blocks (e.g., "qzcli res --list" under "# List cached workspaces") with no explanations of concepts Claude already knows. Minor trimming is possible: the Quick Start repeats commands restated in the Authentication and Resource Discovery sections, and the dense "Environment contract" paragraph could be tightened. Efficient with minor over-explanation, so anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Everything is copy-paste executable: login variants, resource discovery, both interactive and non-interactive create with a full parameter table, a complete batch_config.json example with template semantics, job management commands, and a troubleshooting table mapping error messages to fixes. This matches "fully executable; copy-paste ready; covers common cases".

5 / 5

Workflow Clarity

Quick Start sequences login → res -u → avail → ls, and --dry-run provides explicit validation checkpoints before both single and batch submission ("Preview before submitting", "Preview all jobs"), which satisfies the batch-operation validation concern. However there is no post-submit verification (e.g., status/watch to confirm the job started) and no check before the destructive `qzcli stop JOB_ID`. Clear sequence with most checkpoints but minor validation gaps, so anchor 4 rather than the feedback-loop-complete anchor 5.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but the entire ~320-line CLI reference — full parameter table, batch config format, HPC submission, and troubleshooting rows — is inlined in SKILL.md with no bundle files at all. Content that clearly belongs in a separate reference file is inline, matching anchor 3; it does not reach anchor 4 because there are no one-level-deep bundle references, and it is above anchor 2 because section organization is good rather than a structureless wall.

3 / 5

Total

16

/

20

Passed

Description

82%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 with an explicit, bilingual trigger list and a clear what/when structure. Its only notable weakness is that the capability statement is a single generic action ("manage") rather than an enumeration of the concrete operations the tool supports.

Suggestions

Enumerate the concrete capabilities as actions (e.g., "Submit, stop, list, and batch-submit GPU training jobs; discover workspaces and available nodes") instead of the single generic verb "manage".

Add commonly used natural phrases to the trigger list, such as "login", "check free GPUs/nodes", or "workspace", since users may ask for those before naming the tool.

Trim less-obvious trigger terms like "avail" and "查计算组" in favor of broader user-side phrasings unless those exact tokens are common in the target user base.

DimensionReasoningScore

Specificity

"Manage GPU compute jobs on the Qizhi (启智) platform using qzcli" names a specific domain and one concrete action, but the individual capabilities (submit, stop, list, batch) appear only as trigger terms rather than described actions. This matches 'names domain and 1-2 concrete actions, but not comprehensive' better than the generic-action anchor 2, and lacks the several explicitly listed actions of anchor 4.

3 / 5

Completeness

It clearly states what the skill does ("Manage GPU compute jobs on the Qizhi platform using qzcli — a kubectl-style CLI tool") and explicitly when to use it via an explicit "Use when user says..." clause with concrete trigger phrases. This matches the anchor-5 example structure exactly, and is well above the weakly-implied-when of anchor 3.

5 / 5

Trigger Term Quality

The trigger list ("qzcli", "启智平台", "submit job", "stop job", "查计算组", "avail", "list jobs", "batch submit") gives good bilingual coverage including synonyms and a fallback condition, but misses natural phrasings like "login", "check nodes/GPUs", or "workspace". Good coverage with a few natural terms missing, so anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (Qizhi platform, qzcli tool, distributed training jobs) with platform-specific triggers unlikely to fire for any other skill. Minimal conflict risk, matching anchor 5; it is far more distinct than the overlapping-domains case of anchor 4.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
wanshuiyin/Auto-claude-code-research-in-sleep
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.