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.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%Weight 40%Scale 1-3

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 concise, well-organized instruction standard that provides concrete formats and examples for an instruction-only skill, with no concept-padding and no need for external bundle files. It fully respects the token budget while remaining highly actionable.

Dimension	Reasoning	Score
Conciseness	The body is lean and well-sectioned with no padding of concepts Claude already knows; bullets like "Distill durable facts under ## Observations as - [category] fact" earn their place and assume Claude's competence, matching the "lean and efficient; every token earns its place" anchor.	3 / 3
Actionability	For an instruction-only skill it gives concrete, copy-paste-ready formats and examples ("- [category] fact", "- relation_type [[Target Note]]", "- [branch] feat/bm-writing", frontmatter fields repository/branch/git_sha), matching the "specific examples; copy-paste ready" anchor.	3 / 3
Workflow Clarity	This is a single-purpose writing standard, well-organized into clear sections with an Evidence Boundary acting as explicit constraints; per the simple-skills note, a clear single-task skill scores 3, and it is not a risky multi-step operation needing validation checkpoints.	3 / 3
Progressive Disclosure	The skill is a single self-contained file with no need for external references and is organized into clear topical sections (Voice, Tell The Story, Anchor The Work, Preserve The Semantic Layer, Evidence Boundary), matching the note that skills with no external-reference need score 3 with well-organized sections.	3 / 3
	Total	12 / 12 Passed

Description

75%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly carves a distinctive Basic Memory niche and supplies an explicit "Use with..." trigger, answering both what and when. It is slightly weaker on specificity and trigger-term naturalness, leaning on product jargon and listing contexts rather than multiple concrete actions.

Suggestions

Lead with concrete actions the skill performs (e.g., "Shape, structure, and anchor Basic Memory notes...") before the usage contexts, to raise specificity from domain-plus-one-action to multiple concrete actions.

Add plainer natural trigger terms a user might actually say (e.g., "notes", "remember", "project memory") alongside the product-specific ones like "bm-remember" and "decision captures".

Consider trimming the dense jargon phrase "the basic-memory output style's decision captures" to a more naturally spoken phrasing to improve trigger-term quality.

Dimension	Reasoning	Score
Specificity	It names the domain and a concrete action ("Apply the user-customizable writing standard for Basic Memory notes created or substantially revised") but enumerates usage contexts rather than multiple distinct concrete actions, matching the "names domain and some actions, but not comprehensive" anchor.	2 / 3
Completeness	It answers both what ("Apply the user-customizable writing standard...") and when via an explicit "Use with bm-remember...and other Basic Memory note-writing workflows" trigger clause, satisfying the "clearly answers both what AND when with explicit triggers" anchor rather than capping at 2.	3 / 3
Trigger Term Quality	Relevant keywords appear ("Basic Memory notes", "bm-remember", "note-writing workflows", "writing standard"), but several are jargon-leaning ("bm-remember", "basic-memory output style's decision captures") and plainer common variations are missing, fitting the "some relevant keywords but missing common variations" anchor.	2 / 3
Distinctiveness Conflict Risk	The description is tightly bound to a specific niche (Basic Memory, bm-remember, the basic-memory output style) with distinct triggers, making it unlikely to fire for unrelated skills, matching the "clear niche with distinct triggers" anchor.	3 / 3
	Total	10 / 12 Passed

Validation

100%

Warnings & errors only

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: plugins/claude-code/skills/bm-writing/SKILL.md
Commit: cb95e59

Reviewed: 11 days ago

Table of Contents

Discovery Implementation Validation

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.