CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cmux-workspace-status

Pin the current cmux workspace to the done lane with `cmux workspace status set done` once a session goal is reached and verified. Use at the end of a work session running inside a cmux terminal, right before the final response; skip when work is blocked, handed off, awaiting user input, or when nothing was changed.

Quality

86%

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

The canonical home for this skill is cmux-workspace-status in phatblat/dotfiles

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 body is a maximally lean delegation stub: perfectly concise and clearly signaled, but it contains none of its own task guidance — the command, timing, and verification logic all live in an external file not shipped with the bundle. It works as a redirect but is not self-contained.

Suggestions

Inline the core directive in the body (e.g., run `cmux workspace status set done` when the session goal is reached and verified) so the skill remains actionable even if the shared skill at ~/.agents/skills/cmux-workspace-status/SKILL.md is unavailable.

Add a fallback or validation step for the delegation, such as checking that the shared skill file exists before relying on it, or stating what to do when it is missing.

Fix the dangling references: point to bundle-relative paths where possible and remove or correct the mention of scripts/agent-harnesses.py, since no scripts/ directory exists in this bundle.

DimensionReasoningScore

Conciseness

The body is two lines — a generated-by marker and "Load and follow the shared skill at `~/.agents/skills/cmux-workspace-status/SKILL.md`" — with zero padding and nothing Claude doesn't need. Every token earns its place; this matches the lean anchor 5 exactly.

5 / 5

Actionability

The single instruction is concrete (an exact path to load and follow), but the executable guidance for the skill's actual task — the `cmux workspace status set done` command, when to run it, how to verify the goal — is entirely absent from the body and delegated to an external file outside the bundle. This fits anchor 3 (concrete but incomplete, missing key details) better than anchor 4, which expects actual code or commands in the content.

3 / 5

Workflow Clarity

As a simple single-task skill the one action ("Load and follow the shared skill...") is unambiguous, which supports a high score under the simple-skill exception. However the body provides no checkpoints or fallback for the delegation itself — nothing to do if the shared skill file is absent — and no steps for the underlying status-setting operation, leaving minor validation gaps characteristic of anchor 4 rather than a clean 5.

4 / 5

Progressive Disclosure

The reference is clearly signaled and one level deep (no nested chains), and nothing that belongs in a separate file is inlined. It stops short of anchor 5 because the pointer targets an absolute path outside the bundle (`~/.agents/skills/...`) rather than a bundle-relative file, and the header comment cites `scripts/agent-harnesses.py` which does not exist in the bundle (no references/, scripts/, or assets/ directories are present).

4 / 5

Total

16

/

20

Passed

Description

92%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 states the exact command, explicit timing triggers, and explicit skip conditions in third-person imperative voice with no fluff. The only weakness is modest synonym coverage for trigger phrases.

DimensionReasoningScore

Specificity

"Pin the current cmux workspace to the done lane with `cmux workspace status set done`" names the exact command, the target state (done lane), and the condition ("once a session goal is reached and verified") — fully concrete and comprehensive for a single-action skill. It exceeds anchor 4 because there are no gaps in coverage: the skill has one action and it is stated verbatim.

5 / 5

Completeness

Both questions are answered explicitly: the what ("Pin the current cmux workspace to the done lane with `cmux workspace status set done`") and the when ("Use at the end of a work session running inside a cmux terminal, right before the final response"), plus concrete skip conditions ("blocked, handed off, awaiting user input, or when nothing was changed"). This matches the anchor 5 example's structure of what + explicit trigger guidance, and the 'Use when' clause is present so no cap applies.

5 / 5

Trigger Term Quality

Natural domain terms are present: "cmux terminal", "workspace", "done", "work session", "session goal" — the phrases a cmux user would actually say. It falls short of anchor 5 because common synonyms and variations ("finish session", "wrap up", "complete", "mark done") are absent.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — cmux workspace lifecycle management — anchored by the product-specific terms "cmux", "workspace", and "done lane" and the literal command. Minimal conflict risk with any generic skill; it would not plausibly trigger for the wrong skill.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/cmux-workspace-status/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.