memory-system

Stores and recalls user preferences and project conventions across sessions via a MEMORY.md index.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill memory-system-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: memory-system
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/memory-system
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill memory-system-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents lose all context between sessions, forcing users to re-explain preferences, coding conventions, and past decisions every time. This Skill provides persistent, searchable memory so agents recall what was already learned instead of re-discovering it. ## Core Features & Use Cases - Structured Memory Index: Maintains a lightweight MEMORY.md index (max 200 lines) pointing to topic files for user preferences, project conventions, tech decisions, and feedback history. - Four Memory Operations: Save, recall, search, and prune memories triggered by phrases like "remember this" or "what do you remember about X". - Session Start Protocol: Automatically reads the memory index at session start and silently applies relevant context without reciting it. - Use Case: A user says "remember that we use bun instead of npm". The agent saves it to project-conventions.md, updates the index, and in future sessions automatically uses bun in all commands without being told again. ## Quick Start Ask the agent to remember a preference or convention, such as telling it to remember that you prefer concise responses and use PowerShell on Windows.

Frequently Asked Questions about memory-system

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

FAQPage Schema
How do I make an AI agent remember my preferences across sessions?▼

Use trigger phrases like "remember this" or "don't forget" and the agent saves the information to a topic file under .agents/memory with a one-line pointer in MEMORY.md. At the next session start, the agent reads the index and applies your preferences silently.

What types of information should be saved in agent memory?▼

Save four types: user preferences (role, tools, style), feedback (what you liked or disliked), project conventions (coding standards, tech choices), and references (non-sensitive infrastructure notes). Each type maps to a dedicated topic markdown file.

What should not be stored in persistent agent memory?▼

Never store secrets, API keys, passwords, or credentials since memory persists across sessions. Also avoid information derivable from code, temporary debug context, exact code snippets, and full conversation transcripts.

How does the agent search existing memories?▼

When you ask "do I have any notes about X", the agent runs Grep across all markdown files in .agents/memory and returns matching entries with file references. It can then read the full topic file if you want details.

What happens when the memory index gets too large?▼

When MEMORY.md exceeds 200 lines, the agent warns you and suggests merging related entries or archiving old ones to memory/archive. It never auto-deletes anything and always asks for your confirmation first.