Mem Promote
- 14 installs
- Updated August 4, 2026
- akunzai/agent-skills
mem-promote is a Claude Code skill that promotes verified candidate daily-log notes into durable long-term agent memory files and prunes those files for duplicates and contradictions.
About
mem-promote reviews verified [Candidate] notes from daily logs and promotes the durable ones into long-term memory files like ~/.agents/AGENTS.md or a project AGENTS.md/CLAUDE.md. It also prunes those durable files for duplicates, obsoletes, and contradictions. A developer uses it when consolidating agent conventions so long-term memory stays lean and current. It only promotes facts that are verified, reusable, and stable, and it asks for confirmation before editing.
- Promotes verified [Candidate] daily-log notes into durable long-term memory (~/.agents/AGENTS.md or project AGENTS.md/CL
- Prunes durable memory files for duplicates, obsoletes, and contradictions
- Always shows the exact diff and requires confirmation before editing durable files
Mem Promote by the numbers
- 14 all-time installs (skills.sh)
- Ranked #2,126 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
mem-promote capabilities & compatibility
- Capabilities
- memory recall · memory sync
- Use cases
- memory · documentation
- Pricing
- Free
What mem-promote says it does
Promote only Verified + Reusable + Stable facts; exclude handoff-only transient notes.
Keep durable files lean (aim under 100 lines).
npx skills add https://github.com/akunzai/agent-skills --skill mem-promoteAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 14 |
|---|---|
| Last updated | August 4, 2026 |
| Repository | akunzai/agent-skills ↗ |
What it does
Consolidate verified agent notes into durable memory files and prune those files for duplicates and contradictions.
Who is it for?
Curating durable cross-session agent memory in AGENTS.md or CLAUDE.md files
Skip if: Editing short-term daily logs or transient handoff notes
When should I use this skill?
Reviewing candidate notes for promotion or consolidating durable conventions
What you get
Verified, reusable, stable facts are promoted into lean durable memory files with duplicates pruned.
- Promoted durable memory entries
- Pruned long-term memory files
By the numbers
- 4 promotion criteria (Verified, Reusable, Stable, plus handoff exclusion)
- durable files aim under 100 lines
Files
mem-promote — Promotion & Long-Term Prune
Curates durable memory. Two related jobs, both editing long-term files only:
1. Promote verified [Candidate] notes into ~/.agents/AGENTS.md (global) or project AGENTS.md (fallback CLAUDE.md) — see references/promote.md. 2. Prune those durable files for duplicates, obsoletes, and contradictions — see references/prune.md.
Rules (summary)
- Promote only Verified + Reusable + Stable facts; exclude handoff-only transient notes.
- Strip
[HH:MM]timestamps when promoting, to keep durable files timeless. - On approval, mark the daily-log entry
[Promoted]; on decline, mark it[Rejected]
so short-term cleanup is not blocked by an unresolved candidate.
- Always present the exact diff/plan and get confirmation before editing durable files.
- Keep durable files lean (aim under 100 lines).
Memory Promotion Specifications
This reference provides the checklist and workflows required to safely promote a candidate memory to a long-term durable convention.
1. The Promotion Criteria
Before any entry flagged as [Candidate] is eligible for promotion to durable memory, the Agent must verify it against these four rules:
- [ ] Verified: The fact, fix, or workflow has been proven to work successfully in the current workspace.
- [ ] Reusable: The convention has a high probability of being useful in future sessions or to other developers on the project.
- [ ] Stable: It represents a lasting architectural choice, coding guideline, or tool configuration, not a temporary hack.
- [ ] Not Handoff-Only: Exclude transient continuation details such as current TODOs, partial verification status, open blockers, or suggested skills unless they reveal a stable convention.
2. Interactive Promotion Workflow
1. Scan: Identify [Candidate] memories in .memories/YYYY-MM-DD.md (project) or memories/YYYY-MM-DD.md (user). 2. Filter: Exclude any candidates that do not satisfy the promotion criteria above.
- Treat short-term handoff notes as source material, not durable memory. Promote only the reusable rule or workflow behind them.
3. Format: Draft a concise entry suitable for the global core ~/.agents/AGENTS.md (global durable memory) or project AGENTS.md (fallback to CLAUDE.md if AGENTS.md is absent).
- Clean-up Rule: Strip out daily time stamps (e.g.,
[HH:MM]) to keep durable files timeless and strictly concise.
4. Confirm: Propose the drafted change to the user:
"I found a stable convention in today's notes. Would you like me to promote it to local AGENTS.md (or CLAUDE.md)?"
5. Write & Log: Upon user approval:
- Global Scope: Write reusable durable memory to the canonical core
~/.agents/AGENTS.md. - Project Scope: Write the entry to
<repo>/AGENTS.md(orCLAUDE.mdifAGENTS.mdis absent). - Mark the daily log entry as
[Promoted]to keep logs auditable. - If the user declines promotion, mark the daily log entry
[Rejected](instead of
[Promoted]) so it no longer blocks short-term cleanup as an unresolved candidate.
Memory Pruning Specifications
This reference provides instructions on how to safely compress, clean, and resolve conflicts in global durable memory (~/.agents/AGENTS.md) and local project conventions (AGENTS.md or CLAUDE.md).
1. Pruning Objectives
- Reduce Bloat: Keep durable files under 100 lines so that loading memory in every session remains fast and token-efficient.
- Single Source of Truth: Eliminate outdated memory entries, redundant wording, and retired configurations.
2. Interactive Pruning Workflow
Scan ~/.agents/AGENTS.md (global) or project AGENTS.md (fallback to CLAUDE.md if AGENTS.md is absent) for the following issues:
- Duplicates: Multiple bullet points declaring the exact same durable memory in slightly different words.
- Obsoletes: Outdated dependencies or setups that are no longer part of the workspace.
- Contradictions: Overlapping or conflicting rules. If a decision overrides an old one, write
Replaces: - [Old rule from YYYY-MM-DD]or simply delete the old entry.
Interactive Confirmation
Before committing any changes to the global ~/.agents/AGENTS.md or project AGENTS.md / CLAUDE.md, present the exact diff or cleanup plan to the user:
"I noticed an outdated configuration in AGENTS.md (or CLAUDE.md). Would you like me to replace it with the new settings?"
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kFAQ
Which files does mem-promote edit?
It edits long-term files only: the global ~/.agents/AGENTS.md, or a project AGENTS.md with a fallback to CLAUDE.md.
What notes qualify for promotion?
Only Verified, Reusable, and Stable facts are promoted; handoff-only transient notes are excluded.