CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-comark

Write Basic Memory notes that render as charts, tables, boards, and live views with `::bm-*` Comark components. Use when a note reads better as a figure or board, or already has `::bm-*` directives.

Quality

95%

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 instruction-only skill body: it is lean, teaches only what Claude could not already know, gives paste-ready examples for every common case, and closes with a validation-anchored checklist. The single reference file is well-signaled and appropriately scoped, leaving nothing material to improve.

DimensionReasoningScore

Conciseness

The body is dense with only novel, proprietary information (Comark syntax, query pipeline grammar, error codes) and assumes Claude's competence — e.g., it never explains what Markdown or a table is. Every section earns its tokens; no padded or generic passages are present, matching the 'lean and efficient' anchor.

5 / 5

Actionability

Guidance is fully executable: copy-paste-ready component blocks (`::bm-bars{title="Throughput" ...}` with row grammar), a decision table mapping intent to component names, concrete query pipelines (`notes | where type == decision ... | count`), and an error-code table with a specific fix per code. Per the rubric's instruction-only provision, the absence of script code is not penalized since every example can be pasted directly into a note.

5 / 5

Workflow Clarity

Sections follow the working order (pick → write → live views → edit → errors) with explicit validation checkpoints and feedback loops: 'Read it back after writing a live view and confirm the view has rows before you state a number in prose', error problems that 'never block the write' with instruction to 'fix them right away with edit_note', and a final five-item numbered checklist. This matches the anchor requiring explicit validation, error-recovery loops, and a checklist.

5 / 5

Progressive Disclosure

The body keeps only the 13 most-needed components inline and delegates the full vocabulary ('The full vocabulary, every prop, and every data grammar are in [references/components.md](references/components.md). Read it before using a component you have not used before') to a single, clearly signaled, one-level-deep reference that exists on disk (740 lines). Navigation is easy and the split is appropriate, matching the anchor-5 structure.

5 / 5

Total

20

/

20

Passed

Description

87%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 a concrete capability, uses third-person imperative voice, and provides an explicit 'Use when...' trigger with both a natural-language condition and a directive-based condition. It only falls short of full marks on specificity (one action verb) and a few missing natural synonyms like 'kanban' or 'graph'.

DimensionReasoningScore

Specificity

Names the domain ("Basic Memory notes") and several concrete output forms ("charts, tables, boards, and live views") plus the mechanism ("`::bm-*` Comark components"), matching the 'several specific actions; minor gaps' anchor. It stays below anchor 5 because a single verb ("Write") carries all capability — unlike the multi-verb 'extract, fill, merge, convert' pattern — and above anchor 3 because more than 1-2 concrete elements are stated.

4 / 5

Completeness

Explicitly answers both: what ("Write Basic Memory notes that render as charts, tables, boards, and live views with `::bm-*` Comark components") and when ("Use when a note reads better as a figure or board, or already has `::bm-*` directives") with concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Includes natural phrases a user would say ("a note reads better as a figure or board", "charts", "tables", "board") plus the distinctive "`::bm-*` directives" trigger, giving good keyword coverage. A few natural synonyms (e.g., 'kanban', 'graph', 'visual', 'diagram') are missing, so it does not reach anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers: "Basic Memory" notes, "Comark", and "`::bm-*`" are unambiguous identifiers unlikely to collide with other skills. The generic words 'charts'/'tables' carry some theoretical overlap with visualization skills, but the explicit 'Use when' clauses anchor them to note-writing, keeping conflict risk minimal.

5 / 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

basicmachines-co/basic-memory

Path

skills/memory-comark/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.