bm-writing

Applies a customizable writing standard to Basic Memory notes created or revised by Claude.

4.0k|282|Updated Dec 2, 2024
One-click install
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-writing-basicmachines-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bm-writing
Source: https://github.com/basicmachines-co/basic-memory/tree/main/plugins/claude-code/skills/bm-writing
Command: npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-writing-basicmachines-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Notes written by AI assistants often lack narrative context, consistent structure, and honest evidence boundaries, making them hard to understand later. This Skill enforces a shared, user-editable writing standard so every Basic Memory note remains useful project memory rather than a vague status dump. ## Core Features & Use Cases - Narrative Structure: Shapes notes around problem, approach, and current state, with concrete component names, paths, and commands instead of generic summaries. - Semantic Layer Preservation: Distills durable facts as categorized observations and records graph relations as typed wikilinks under dedicated sections. - Work Anchoring: Captures repository, branch, PR, and commit sha context in frontmatter or observations when notes record repository work. - Use Case: After a coding session, Claude writes a checkpoint note that explains why an approach was chosen, links related notes, and anchors the branch and commit sha, so a future session can resume with full context. ## Quick Start Ask Claude to write a Basic Memory note about the work just completed using the bm-writing standard.

Frequently Asked Questions about bm-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the writing style for Basic Memory notes?▼

Edit the SKILL.md file of the bm-writing skill directly to adjust voice, emphasis, and preferred structure. The file is intentionally user-customizable, and task-specific skills still control required metadata and schemas.

How should decisions be recorded in Basic Memory notes?▼

Record decisions as [decision] observations under the Observations section, not as plain bullets in a separate Decisions section. This keeps durable facts in one consistent, categorized format.

What git information should a coding-session note include?▼

Coding-session checkpoints require repository, branch, and git_sha in frontmatter, with typed pull-request fields. Other anchors like branch or PR numbers can be recorded as observations such as - [branch] feat/name.

Can I use this writing standard with other Basic Memory skills?▼

Yes, it is designed to work with bm-remember, the basic-memory output style's decision captures, and other note-writing workflows. It shapes the note's prose but never overrides task-specific schemas or factual constraints.

What are the limitations of AI-written project notes?▼

AI-written notes risk inventing intent, impact, or verification that never happened. This standard requires stating uncertainty plainly and never claiming a test or deployment passed unless it actually ran or the user supplied the result.