Skill

persona-memory

Build and operate a persistent persona and memory framework for Claude Code. Use when setting up personality.md injection, durable memory blocks in ~/.ai-memory, session start/end memory workflows, recall/remember/consolidate scripts, or packaging a distributable memory skill profile.

Install

npx claudepluginhub fairchild/dotclaude --plugin skill-creator

Tool Access

This skill uses the workspace's default tool permissions.

Preview

General memory framework for teammate-style agents.

Supporting Assets

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

167.4k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

167.4k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

167.4k

Stats

Stars1

Forks0

Last CommitMar 21, 2026

Actions

View Source View Plugin View on GitHub View README

Persona Memory

General memory framework for teammate-style agents.

This skill is framework-first: any specific persona (for example Bertram) should be implemented as a profile by providing personality.md and using the shared memory store.

Current Scope (Experimental)

Local-first memory store in ~/.ai-memory.
Personality/profile loading via launcher and appended prompt context.
Scripted remember/recall/consolidate/session lifecycle hooks.
Deterministic + live-smoke test harness and curation dashboard.

Not Yet Implemented

Continuous background memory agents (always-on consolidation/recall loops).
Autonomous cross-project relationship learning and long-horizon planning.
Production-stability guarantees or backward-compatibility promises.
Full interactive Claude session integration testing in CI.

Quick Start

Initialize memory store and defaults:

bun ~/.claude/skills/persona-memory/scripts/bootstrap.ts --install-launcher

Launch Claude with persona-memory:

claude-persona

Optional: set profile per shell/session:

export AI_MEMORY_PROFILE=default

What This Skill Provides

scripts/launch-claude.sh: Claude launcher wrapper that appends personality.md and recall context.
scripts/bootstrap.ts: Creates ~/.ai-memory structure and starter files.
scripts/remember.ts: Writes candidate memory events.
scripts/recall.ts: Reads memory blocks and returns relevant context.
scripts/consolidate.ts: Promotes events into stable memory blocks.
scripts/session-start.ts: Hook-friendly startup memory snapshot.
scripts/session-end.ts: Hook-friendly sleep-time consolidation.

Runtime Data

Persistent memory root:

~/.ai-memory

Profile-based personalities:

~/.ai-memory/profiles/<profile>/personality.md

Dev Search Standard

Prefer rg/rg --files for codebase search and file discovery.
Use grep only when strict POSIX portability is required.

Hook Setup

Read:

references/hook-setup.md

Add hooks to your ~/.claude/settings.json for session lifecycle automation.

References

references/personality-contract.md
references/memory-schema.md
references/scoring-and-promotion.md
references/hook-setup.md
references/TESTING.md