memory-merger
Helps your agent merge learned lessons into a memory file. This improves the agent's knowledge on a specific topic.
What it does
This tool helps organize and update important knowledge for a project. It takes lessons learned from a 'memory' file and adds them to an 'instructions' file, ensuring nothing is lost and everything is well-organized.
When to use it
- ✓When you learn something new and important in a project and want to save it for the future.
- ✓When you want to combine various tips and information from a project into one place.
- ✓When you want to ensure important knowledge isn't forgotten or becomes confusing.
Example of what to ask your AI
“Please merge the important lessons from my 'prompt engineering' project into my global instructions.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You tell me which type of knowledge (domain) you want to merge and whether it's for all your projects (global) or just the current one (workspace). I then take that knowledge, organize it, and present it for your approval before saving.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add github/awesome-copilot --skill memory-mergerOr download just the file:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/memory-merger/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Memory Merger
You consolidate mature learnings from a domain's memory file into its instruction file, ensuring knowledge preservation with minimal redundancy.
Use the todo list to track your progress through the process steps and keep the user informed.
Scopes
Memory instructions can be stored in two scopes:
- Global (
globaloruser) - Stored in<global-prompts>(vscode-userdata:/User/prompts/) and apply to all VS Code projects - Workspace (
workspaceorws) - Stored in<workspace-instructions>(<workspace-root>/.github/instructions/) and apply only to the current project
Default scope is global.
Throughout this prompt, <global-prompts> and <workspace-instructions> refer to these directories.
Syntax
/memory-merger >domain-name [scope]
>domain-name- Required. The domain to merge (e.g.,>clojure,>git-workflow,>prompt-engineering)[scope]- Optional. One of:global,user(both mean global),workspace, orws. Defaults toglobal
Examples:
/memory-merger >prompt-engineering- merges global prompt engineering memories/memory-merger >clojure workspace- merges workspace clojure memories/memory-merger >git-workflow ws- merges workspace git-workflow memories
Process
1. Parse Input and Read Files
- Extract domain and scope from user input
- Determine file paths:
- Global:
<global-prompts>/{domain}-memory.instructions.md→<global-prompts>/{domain}.instructions.md - Workspace:
<workspace-instructions>/{domain}-memory.instructions.md→<workspace-instructions>/{domain}.instructions.md
- Global:
- The user can have mistyped the domain, if you don't find the memory file, glob the directory and determine if there may be a match there. Ask the user for input if in doubt.
- Read both files (memory file must exist; instruction file may not)
2. Analyze and Propose
Review all memory sections and present them for merger consideration:
## Proposed Memories for Merger
### Memory: [Headline]
**Content:** [Key points]
**Location:** [Where it fits in instructions]
[More memories]...
Say: "Please review these memories. Approve all with 'go' or specify which to skip."
STOP and wait for user input.
3. Define Quality Bar
Establish 10/10 criteria for what constitutes awesome merged resulting instructions:
- Zero knowledge loss - Every detail, example, and nuance preserved
- Minimal redundancy - Overlapping guidance consolidated
- Maximum scannability - Clear hierarchy, parallel structure, strategic bold, logical grouping
4. Merge and Iterate
Develop the final merged instructions without updating files yet:
- Draft the merged instructions incorporating approved memories
- Evaluate against quality bar
- Refine structure, wording, organization
- Repeat until the merged instructions meet 10/10 criteria
5. Update Files
Once the final merged instructions meet 10/10 criteria:
- Create or update the instruction file with the final merged content
- Include proper frontmatter if creating new file
- Merge
applyTopatterns from both memory and instruction files if both exist, ensuring comprehensive coverage without duplication
- Remove merged sections from the memory file
Example
User: "/memory-merger >clojure"
Agent:
1. Reads clojure-memory.instructions.md and clojure.instructions.md
2. Proposes 3 memories for merger
3. [STOPS]
User: "go"
Agent:
4. Defines quality bar for 10/10
5. Merges new instructions candidate, iterates to 10/10
6. Updates clojure.instructions.md
7. Cleans clojure-memory.instructions.md
FAQ
What do 'global' and 'workspace' mean?
'Global' means the instructions apply to all your projects. 'Workspace' means they only apply to the project you are currently working on.
What happens if the memory file doesn't exist?
The tool needs the memory file to work. If it doesn't exist, it will try to find something similar and ask for your help to confirm.
How does the tool ensure the knowledge is good?
It has a 10/10 standard that checks if all knowledge is preserved, if there are no repetitions, and if everything is easy to read and understand.
Details
Original description by the author
Merges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `workspace`, or `ws`.
repo: github/awesome-copilot
Popularity
- GitHub stars
- 40k
- Ranking position
- #5230
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
acquire-codebase-knowledge
Helps your agent understand and document an existing code project. It's useful for onboarding new people or getting an overview of the architecture.
github/awesome-copilot
acreadiness-assess
Enables your agent to assess a project's readiness for AI and generate a report. It's useful for understanding how well a project is prepared to use AI tools.
github/awesome-copilot
acreadiness-generate-instructions
Helps your agent create instructions for AI tools based on an assessment. It's useful for improving how AI interacts with code and closing identified gaps.
github/awesome-copilot
acreadiness-policy
Enables your agent to help define or apply policies for AI project assessment. It's useful for standardizing how projects are evaluated and ensuring compliance.
github/awesome-copilot
Similar skills
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC