para-memory-files

Organizes knowledge into PARA-based memory layers with weekly synthesis and recall via qmd.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/XiaoPuOuO/VFactory --skill para-memory-files-xiaopuouo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: para-memory-files
Source: https://github.com/XiaoPuOuO/VFactory/tree/main/paperclip-official/AgentSetting/skills/para-memory-files
Command: npx skills add https://github.com/XiaoPuOuO/VFactory --skill para-memory-files-xiaopuouo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Persistent, file-based memory system using Tiago Forte's PARA method to store, retrieve, update, and organize knowledge across sessions. It provides three memory layers: a knowledge graph in PARA folders with atomic YAML facts, daily notes as a raw timeline, and tacit knowledge about user patterns. It also handles planning files, memory decay, weekly synthesis, and recall via qmd. Trigger on any memory operation: saving facts, writing daily notes, creating entities, running weekly synthesis, recalling past context, or managing plans.

Core Features & Use Cases

  • Layer 1: Knowledge Graph — $AGENT_HOME/life/ with folders per entity; each entity has summary.md and items.yaml; durable facts stored and fact-status management; references to related_entities; and Archiving rules.
  • Layer 2: Daily Notes — $AGENT_HOME/memory/YYYY-MM-DD.md as a raw timeline; extract durable facts to Layer 1 during heartbeats.
  • Layer 3: Tacit Knowledge — $AGENT_HOME/MEMORY.md capturing patterns, preferences, lessons; updated over time.
  • Planning and recall — plans stored under plans/ for cross-agent access; qmd queries for semantic search; no deletion; memory decay and synthesis weekly.

Quick Start

Create a new entity under $AGENT_HOME/life/ with a summary.md and items.yaml, then add today's daily note under memory/ to begin capturing facts.

Frequently Asked Questions about para-memory-files

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

FAQPage Schema
How do I organize persistent knowledge across sessions using the PARA method?

To organize persistent knowledge across sessions using the PARA method, this system stores durable facts in a structured knowledge graph under life/ folders, captures raw timelines in daily notes, and applies memory-decay rules during weekly synthesis. It separates entities, daily logs, and tacit patterns into three distinct layers.

What is the best way to manage daily notes and extract durable facts for knowledge management?

The best way to manage daily notes for knowledge management is to save raw timelines as memory/YYYY-MM-DD.md files, then extract durable facts into the knowledge graph's items.yaml during heartbeats. This ensures temporary logs are processed into structured entity summaries without manual duplication.

Can I use file-based memory to track tacit user patterns and preferences over time?

Yes, you can track tacit user patterns and preferences over time using a dedicated MEMORY.md file. This third memory layer captures long-term lessons and behavioral patterns, updating gradually alongside the knowledge graph and daily notes to maintain a persistent user profile.

How does weekly synthesis work with memory-decay rules in a personal knowledge base?

Weekly synthesis works by reviewing accumulated daily notes and knowledge graph entities, applying memory-decay rules to archive outdated information, and consolidating remaining context. This process triggers via qmd queries to recall past context and refresh planning files without deleting historical data.

Do I need YAML files to store atomic facts when building a PARA-based knowledge graph?

Yes, you need YAML files to store atomic facts when building this knowledge graph. Each entity folder requires a summary.md for overviews and an items.yaml file to structure durable facts, manage fact-status, and link related entities within the PARA folders.

How do I query past context and manage plans across different agents?

You query past context and manage plans by triggering qmd for semantic search recall and storing plans under a shared plans/ directory for cross-agent access. This approach ensures planning files remain separate from the core memory layers while remaining accessible.