A formatting guide for MIF Level 3, a file format for storing structured memories in Markdown. It defines required fields, optional fields, file names, and templates.

Use it to create, name, and format mnemonic memory files. It helps define memory types, namespaces, dates, tags, and other metadata.

It removes guesswork when creating memory files that can be found and combined consistently. It also explains which information is required and which is optional.

format — Skill for Claude Code by modeled-information-format/mnemonic

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add modeled-information-format/mnemonic --skill format

Clone the repo

git clone --depth 1 https://github.com/modeled-information-format/mnemonic

Made for: Claude Code.

Or install mnemonic, the plugin that ships this one along with the rest of its 10 skills, 14 commands, 4 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/modeled-information-format/mnemonic/format/github.svg)](https://agentmods.dev/skills/modeled-information-format/mnemonic/format)

Your own site

<a href="https://agentmods.dev/skills/modeled-information-format/mnemonic/format"><img src="https://agentmods.dev/badge/skills/modeled-information-format/mnemonic/format/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/modeled-information-format/mnemonic/format"><img src="https://agentmods.dev/badge/skills/modeled-information-format/mnemonic/format.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,896 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00024	$0.01896
Opus 5.5	$0.00010	$0.00758
Sonnet 5.5	$0.00005	$0.00379
Haiku 4.5	$0.00002	$0.00190

Measured 13d ago against content hash f70e1fcd8e86, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

format scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/format/SKILL.md · 229 lines

How it starts

The opening of the file, as written. The whole thing — 229 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Memory

Search first: /mnemonic:search {relevant_keywords} Capture after: /mnemonic:capture {namespace} "{title}"

Run /mnemonic:list --namespaces to see available namespaces from loaded ontologies.

Mnemonic Format Skill

MIF (Modeled Information Format) 1.4.2 Level 3 templates and formatting guidelines.

Concept frontmatter keys are camelCase (MIF 1.4.2 section 3.3). Older mnemonic memories may still carry snake_case keys (valid_from, source_type, compressed_at), relates_to relationship types, bare-UUID targets and [[uuid]] wiki-links. Those are still read, but always write the forms below. tools/mnemonic-migrate-mif upgrades old files on request.

Trigger Phrases

"memory format", "MIF format", "frontmatter template", "memory template", "mnemonic schema"

Quick Start: Minimal Memory

Only 4 fields are required. Everything else is optional.

---
id: 550e8400-e29b-41d4-a716-446655440000
title: "Human-readable title"
type: semantic
created: 2026-01-23T10:30:00Z
---

# Title

Content here.

That's it. Add optional fields only when you need them.

File Naming

{slug}.memory.md

slug: URL-safe title, lowercase, max 50 chars
UUID is stored only in the frontmatter id: field
If a file with the same slug already exists, content is merged
MIF 1.4.2 names concept files {slug}.md and calls the .memory infix legacy. mnemonic keeps {slug}.memory.md because its search, hooks and tools all glob *.memory.md.

Full Optional Fields Reference

---
# REQUIRED (always include these 4)
id: 550e8400-e29b-41d4-a716-446655440000
title: "Human-readable title"
type: semantic
created: 2026-01-23T10:30:00Z

# COMMON
modified: 2026-01-23T14:22:00Z
namespace: _semantic/decisions/project
tags:
  - architecture
  - database

# BI-TEMPORAL TRACKING
temporal:
  validFrom: 2026-01-23T00:00:00Z
  validUntil: null
  recordedAt: 2026-01-23T10:30:00Z
  ttl: P90D
  decay:
    model: exponential
    halfLife: P7D
    strength: 0.85
  accessCount: 5
  lastAccessed: 2026-01-23T14:22:00Z

# PROVENANCE
provenance:
  sourceType: agent_inferred      # user_explicit | user_implicit | agent_inferred | external_import | system_generated
  sourceRef: file:///path/to/source.ts:42
  agent: claude-opus-4
  confidence: 0.95
  trustLevel: moderate_confidence # verified | user_stated | high_confidence | moderate_confidence | low_confidence | uncertain
  sessionId: abc123

# RELATIONSHIPS (authoritative; mirrored in the body, see below)
relationships:
  - type: relates-to
    target: urn:mif:7c9e6679-7425-40de-944b-e07fc1f90ae7
  - type: supersedes
    target: urn:mif:f47ac10b-58cc-4372-a567-0e02b2c3d479
    metadata:
      label: "Replaced after the 2026 review"

# CODE REFERENCES (mnemonic extension)
codeRefs:
  - file: src/auth/handler.ts
    line: 42
    symbol: authenticateUser
    type: function                # function | class | method | variable | type

# CITATIONS (MIF 1.4.2 section 5.4)
citations:
  - "@type": Citation
    citationType: documentation   # article | book | paper | website | documentation | repository | video | podcast | specification | dataset | tool | other
    citationRole: supports        # see MIF 1.4.2 section 5.4.4
    title: "Source Title"
    url: https://example.com/source
    author: "Author Name"
    date: 2026-01-23
    accessed: 2026-01-23
    relevance: 0.90
    note: "Brief description"

# COMPRESSION (auto-generated by gc --compress)
summary: "Concise 2-3 sentence summary (max 500 chars)"
compressedAt: 2026-01-24T10:00:00Z
---

# Memory Title

Content in markdown format.

## Relationships

- relates-to [Other Memory Title](urn:mif:7c9e6679-7425-40de-944b-e07fc1f90ae7)
- supersedes [Old Memory Title](urn:mif:f47ac10b-58cc-4372-a567-0e02b2c3d479)

Read the full file on GitHub · 229 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

13d ago Changed f70e1fcd8e86
14d ago Changed · +37 lines · +9 tokens per session ea9c2fa8a212
1mo ago First seen · 192 lines · 15 tokens per session scan A 6e289760cb76

Subscribe to this mod's changes

format is a skill published in the GitHub repository modeled-information-format/mnemonic (23 stars, last pushed 9d ago), licensed MIT. It adds 24 tokens to every session and 1,896 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Claude Code Memory and context ai-memory claude-plugin knowledge-management markdown memory-system

reflect

Deep reflection skill - read memory and context, decide whether there is something worth sending.

Bizuayeu/Plugins-Weave · 18 tokens

digest-auto

A skill for analysing the current state of an EpisodicRAG system, which retrieves information from records of past events or work sessions.

Bizuayeu/Plugins-Weave · 22 tokens

digest-setup

An interactive setup process for the early stage of EpisodicRAG, a system that retrieves useful information from past conversations.

Bizuayeu/Plugins-Weave · 19 tokens

digest-config

An interactive configuration tool for EpisodicRAG, a system that retrieves relevant information from past interactions or events.

Bizuayeu/Plugins-Weave · 16 tokens

okf

Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one after code or docs change, or when a…

scaccogatto/okf-skills · 127 tokens

forgetful-remember

Remember knowledge worth keeping — a decision made, a solution found, a preference stated, a pattern confirmed. Use when work surfaces something future sessions will need, or the user asks to remember something. Routes content to the right store (memory, document, code artifact, entity, procedure, file) and enforces…

ScottRBK/forgetful · 71 tokens