CtrlK
BlogDocsLog inGet started
Tessl Logo

bm-writing

Apply the user-customizable writing standard for Basic Memory notes created or substantially revised by Claude. Use with bm-remember, the basic-memory output style's decision captures, and other Basic Memory note-writing workflows.

67

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-code/skills/bm-writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-crafted, lean instruction-only writing standard with concrete format templates and clear sectioned guidance. It could be strengthened by one full worked example note, but otherwise earns its tokens and is appropriately structured.

DimensionReasoningScore

Conciseness

The body is lean and directive, organized into tight sections (Voice, Tell The Story, Anchor The Work, Preserve The Semantic Layer, Evidence Boundary) with no padding or explanation of concepts Claude already knows; every line is actionable guidance that earns its place.

5 / 5

Actionability

It gives concrete, copy-paste-ready format templates ('- [category] fact', '- [branch] feat/bm-writing', '- relation_type [[Target Note]]') and explicit frontmatter requirements ('repository', 'branch', 'git_sha'), but lacks a single consolidated worked example of a complete note, leaving a minor gap.

4 / 5

Workflow Clarity

The sections imply a clear writing process (voice -> narrative -> anchors -> semantic layer -> evidence boundary) and the skill is non-destructive so no validation checkpoint is required; it stops short of an explicit numbered sequence, which keeps it just below a 5.

4 / 5

Progressive Disclosure

The skill is self-contained with no bundle files and no need for external references; content is well-organized into clearly signaled sections, satisfying the simple-skill exception for progressive disclosure on a single well-structured file.

5 / 5

Total

18

/

20

Passed

Description

73%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 focused, niche-specific description that clearly answers what it does and names concrete companion workflows as triggers. It is slightly light on enumerated concrete actions and uses 'Use with' rather than a 'Use when' trigger phrase.

DimensionReasoningScore

Specificity

It names the domain ('Basic Memory notes created or substantially revised by Claude') and the action of applying a writing standard, but does not enumerate multiple distinct concrete actions, matching the 'names domain and 1-2 concrete actions' anchor.

3 / 5

Completeness

It states what ('Apply the user-customizable writing standard...') and when/where ('Use with bm-remember, the basic-memory output style's decision captures, and other Basic Memory note-writing workflows'), but the 'Use with [companion skills]' framing is slightly less explicit as a user-facing trigger than a 'Use when...' clause.

4 / 5

Trigger Term Quality

Natural niche terms a Basic Memory user would say are present ('Basic Memory notes', 'bm-remember', 'decision captures', 'note-writing workflows'), giving good keyword coverage, though a few synonyms/variations are missing.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Basic Memory note-writing standard) with distinct, domain-specific triggers (bm-remember, decision captures), giving minimal conflict risk with unrelated skills.

5 / 5

Total

16

/

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.

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