CtrlK
BlogDocsLog inGet started
Tessl Logo

cmux-markdown

Open markdown files in a formatted viewer panel with live reload. Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering (headings, code blocks, tables, lists).

74

Quality

91%

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

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

An exemplary short skill body: lean, executable, with a clear single-action workflow and a well-structured two-file progressive disclosure that keeps the overview uncluttered. No significant weaknesses across any dimension.

DimensionReasoningScore

Conciseness

The body is lean and direct — executable commands, minimal prose, no explaining of what markdown is or how libraries work — and lines like "Relative paths resolve against the caller's cwd and `~` expands" earn their place. Matches the anchor for lean, efficient content that assumes Claude's competence. Not 4 because there is no over-explanation to trim.

5 / 5

Actionability

Three concrete executable commands with real flags (--workspace/--surface/--window) plus a copy-paste-ready AGENTS.md snippet give fully executable, common-case coverage. Matches the anchor for copy-paste-ready commands covering common cases. Not 4 because the examples cover the common cases with specific, working flags.

5 / 5

Workflow Clarity

As a single-purpose skill (open a .md file), the workflow is unambiguous with a meaningful pre-step ("Write the full plan file first, then open it, so the panel never shows a partially written file") and clear post-open guidance (overwrite/append freely triggers re-render). The simple-skill exception applies; no destructive/batch validation cap is relevant. Not 4 because the single action is unambiguous with a real pre-step.

5 / 5

Progressive Disclosure

The body is a clear overview with a "Deep-dive references" table pointing to two real, one-level-deep files (references/commands.md and references/live-reload.md), each clearly signaled with a "When to Use" column; bulk command syntax and reload internals are correctly split out into those files. Matches the anchor for a clear overview with well-signaled one-level-deep references. Not 4 because navigation is clean and references are genuinely one level deep (verified the files exist and contain the deferred detail).

5 / 5

Total

20

/

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, well-formed description that clearly states both capability and explicit trigger guidance with natural user phrasing. The main gap is action coverage — it foregrounds a single action (open) while the richer detail is about rendering rather than additional distinct capabilities.

Suggestions

Add a second concrete action to broaden capability coverage, e.g. "open and auto-reload .md files" rather than foregrounding only "open".

Include the file extension trigger ".md" alongside "markdown files" so users who mention the extension verbatim match naturally.

DimensionReasoningScore

Specificity

"Open markdown files in a formatted viewer panel with live reload" names one concrete action with rendering detail (headings, code blocks, tables, lists), matching the anchor that names the domain and 1-2 concrete actions but isn't comprehensive. Not 4 because the action set is narrow (just "open") and the rest is rendering detail rather than distinct actions.

3 / 5

Completeness

It explicitly answers both what ("Open markdown files in a formatted viewer panel with live reload") and when ("Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering"), with concrete trigger phrases. Not 4 because the trigger guidance is concrete and explicit rather than weakly implied.

5 / 5

Trigger Term Quality

Natural trigger phrases users would say — "plans, documentation, or notes alongside the terminal" plus "markdown files" — give good keyword coverage, matching the anchor for good coverage with a few natural terms missing. Not 5 because it lacks file-extension synonyms like ".md" and variants like "docs" or "README".

4 / 5

Distinctiveness Conflict Risk

The cmux markdown viewer panel alongside the terminal is a clear, narrow niche with distinct triggers (plans/docs/notes alongside terminal), giving minimal conflict risk with other skills. Not 4 because the triggers are specific enough to avoid firing for unrelated skills.

5 / 5

Total

17

/

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
basicmachines-co/basic-memory
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.