writing-memories

Write or update agent memory files with YAML frontmatter.

1|1|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/SteveBronder/skillrena --skill writing-memories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-memories
Source: https://github.com/SteveBronder/skillrena/tree/main/skillrena/writing-memories
Command: npx skills add https://github.com/SteveBronder/skillrena --skill writing-memories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writes or updates memory files with proper YAML frontmatter in the agent's memories directory.

Core Features & Use Cases

  • Path-based storage: writes to ./.{AGENT_NAME}/skills/memories/<name>/SKILL.md.
  • Header enforcement: ensures required header with name and description.
  • Idempotent updates: updates existing memories without duplication.

Quick Start

  • Write to ./.{AGENT_NAME}/skills/memories/<name>/SKILL.md.
  • Create the directory if needed.
  • Prepend the required header if missing.

Frequently Asked Questions about writing-memories

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

FAQPage Schema
How do I persist agent memories with YAML frontmatter?

Writing memories with YAML frontmatter stores agent learnings durably in `./.{AGENT_NAME}/skills/memories/<name>/SKILL.md`. The Skill creates the directory structure and prepends required headers containing `name` and `description` fields to ensure consistent indexing and retrieval of project knowledge.

What's the correct structure for memory files in an agent project?

Memory files require a hyphenated name identifier, a SKILL.md file, and YAML frontmatter with `name` and `description` keys where description is a single line without colons. Files live in `./.{AGENT_NAME}/skills/memories/<name>/` and are updated idempotently without duplication.

Can I update existing memories without losing prior content?

Yes, the Skill applies idempotent updates to existing memory files. It rewrites or appends to `./.{AGENT_NAME}/skills/memories/<name>/SKILL.md` while preserving the required YAML header, so prior learnings remain intact across edits.

Do I need to manually create memory directories before writing?

No, the Skill creates the required directory structure automatically at `./.{AGENT_NAME}/skills/memories/<name>/` if it doesn't exist, so you only need to provide a valid hyphenated memory name and content.

Why must the frontmatter description be a single line without colons?

Single-line descriptions without colons ensure consistent YAML parsing and reliable indexing across memory retrieval systems. This constraint prevents parsing conflicts and maintains uniform organization in the agent's memory index.