box write

box-write

Save a memory file to Box. Append-only — never overwrites. Generates a ULID, builds YAML frontmatter, composes the markdown body, uploads to the appropriate folder, updates the per-folder _index.json, and on Business+ applies the boxMemory metadata template instance.

Usage

/box-write [content] [--kind=<kind>] [--title=<title>] [--team=<team>] [--tags=<a,b,c>]

Examples:

• /box-write We decided to use JWT instead of sessions. — kind inferred as decision
• /box-write --kind=task --title="Rotate keys" --tags=ops Cron monthly

Kinds

decision · fact · task · observation · reference · note · companion

companion is special — used internally by box-companion. Don't write companions manually; use the dedicated skill.

Statuses

active (default) · draft · superseded · archived · held (Enterprise legal hold)

Supersession

If a new memory replaces an old one, set --supersedes=<mem_id>. The skill:

1. Writes the new memory with supersedes: [<old_id>]
2. Updates the old memory: status: superseded, superseded_by: <new_id>, updated_at: <now>
3. Updates both index entries

Never deletes. Append-only.

Filename convention

<kind>__<slug>.md (double underscore). If slug collides with an existing memory in the same folder, the skill bumps to <slug>-2, <slug>-3, etc.

Body structure (suggested)

# <title>

> One-line summary or callout.

## Context
<why this is being captured>

## Decision (or Fact / Task / etc.)
<the substance>

## Why
<reasoning>

## Related
- [[Other Memory]]

## Open questions
- [ ] ...

Use Obsidian-style [[wikilinks]] for cross-memory references. The related: frontmatter array is the structured graph; body wikilinks are inline reading aids.

Quality bar

• Title is searchable (real words humans would type)
• Body explains WHY, not just WHAT
• Tags sparse — 2-5 per memory
• Wikilinks intentional — only link to memories you've verified exist

When NOT to write

• Conversational acknowledgments
• Recap of code already in git
• Time-bound trivia
• Content the user said don't save

See also

• Schema — full frontmatter spec
• box-recall — find what you wrote
• box-ai-recall — semantic Q&A across what you wrote
• Source: skills/box-write/SKILL.md