Agent skill

Memory File Maintenance

by mohitagw15856 in mohitagw15856/pm-claude-skills

Keep your AI memory/context file (MEMORY.md, CLAUDE.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right.

MITAuto-check passedAgent Workflows

Install Memory File Maintenance

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill memory-file-maintenance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills memory-file-maintenance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/memory-file-maintenance .claude/skills/memory-file-maintenance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
memory-file-maintenance
GitHub stars
1.4k
Token cost
~1.2k tokens
SKILL.md length
574 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Keep your AI memory/context file (MEMORY.md, CLAUDE.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right.

  • Works in 7 steps: Review against reality. Compare what's… → Prune the dead weight. Remove stale… → Sharpen the vague. Turn fuzzy statements… → …
  • Asked review my memory file
  • SKILL.md covers What This Skill Produces, Required Inputs, Framework: Prune, Sharpen,… and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memory File Maintenance is an agent skill from mohitagw15856/pm-claude-skills. Keep your AI memory/context file (MEMORY.md, CLAUDE.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right. Use when asked review my memory file, my AI context is outdated, clean up my CLAUDE.md, or maintain my AI instructions. Produces a review of your existing memory/instructions file (what's stale, contradictory, bloated, or missing), edits to prune and sharpen it, additions from recent patterns worth remembering, and a light…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked review my memory file
  • My AI context is outdated
  • Clean up my CLAUDE.md
  • Maintain my AI instructions

Example prompts

  • “/memory-file-maintenance”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Review against reality. Compare what's in the file to who the person actually is now — files drift as people change.
  2. Prune the dead weight. Remove stale rules, resolved situations, and redundancy — a bloated file dilutes the important stuff and confuses…
  3. Sharpen the vague. Turn fuzzy statements into clear, actionable ones ("be concise" → "lead with the answer, then reasoning") so they…
  4. Resolve contradictions. Surface instructions that conflict (a common cause of inconsistent AI behavior) and pick one.
  5. Add what's missing. Capture new preferences, patterns, and lessons from how the person's actually been working — the file should grow with…
  6. Re-check privacy. Confirm nothing sensitive (credentials, financial, health, others' personal info) has crept in — and remove it if so.
  7. Set a light habit. A quick periodic review plus adding a line when a new pattern emerges keeps it current without being a chore.

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Memory File Maintenance loads about 1.2k tokens when it runs. Until then it costs about 171 tokens; SKILL.md has 574 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~171
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 574 words, ~1,221 tokens.

Download SKILL.mdSave it as .claude/skills/memory-file-maintenance/SKILL.md (or your agent's skills folder).
name
memory-file-maintenance
description
Keep your AI memory/context file (MEMORY.md, CLAUDE.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right. Use when asked review my memory file, my AI context is outdated, clean up my CLAUDE.md, or maintain my AI instructions. Produces a review of your existing memory/instructions file (what's stale, contradictory, bloated, or missing), edits to prune and sharpen it, additions from recent patterns worth remembering, and a light maintenance habit — because a memory file that isn't tended drifts from who you actually are, with a privacy check on what should never be stored.

Memory-File Maintenance

A personal AI memory file (MEMORY.md, CLAUDE.md, custom instructions) is only as good as it is current — over time it bloats with stale rules, contradicts itself, and drifts from who you actually are now. This tends it: reviews what's there, prunes the dead weight, sharpens the vague, adds the new patterns worth keeping, and sets a light maintenance habit — so your AI keeps understanding the real you. It also re-checks the privacy line on what should never be in there.

Not quite this? Use build-my-memory-file when you are starting a memory file from scratch.

What This Skill Produces

  • A health review — what in the current file is stale, contradictory, bloated, redundant, or vague — and what important context is missing
  • Prune & sharpen edits — removing dead rules and tightening vague ones into clear, actionable statements
  • Additions — new patterns, preferences, and lessons worth adding from how you've actually been working/deciding lately
  • A conflict check — surfacing and resolving instructions that contradict each other (which confuse the AI)
  • A privacy re-check — confirming no credentials, financial, health, or others' personal data has crept in
  • A maintenance habit — a light cadence (a quick review every so often, add-a-line-as-you-go) so it stays current

Required Inputs

Ask for these if not provided:

  • The current file — your MEMORY.md / CLAUDE.md / custom instructions (paste it)
  • What's changed — how your work, preferences, or life have shifted since you wrote it
  • Any friction — where the AI has been getting you wrong lately (a clue to what's stale/missing)
  • New patterns — recent rules, lessons, or preferences worth capturing

Framework: Prune, Sharpen, Add, Protect

  1. Review against reality. Compare what's in the file to who the person actually is now — files drift as people change.
  2. Prune the dead weight. Remove stale rules, resolved situations, and redundancy — a bloated file dilutes the important stuff and confuses the AI.
  3. Sharpen the vague. Turn fuzzy statements into clear, actionable ones ("be concise" → "lead with the answer, then reasoning") so they actually work.
  4. Resolve contradictions. Surface instructions that conflict (a common cause of inconsistent AI behavior) and pick one.
  5. Add what's missing. Capture new preferences, patterns, and lessons from how the person's actually been working — the file should grow with them.
  6. Re-check privacy. Confirm nothing sensitive (credentials, financial, health, others' personal info) has crept in — and remove it if so.
  7. Set a light habit. A quick periodic review plus adding a line when a new pattern emerges keeps it current without being a chore.
Show full SKILL.md (163 more words)Show less

Output Format

Memory-file review

Prune (remove): [stale · redundant · resolved]. Sharpen (rewrite vaguer → clearer): ["[vague]" → "[clear, actionable]"]. Contradictions to resolve: [conflicting instructions → the one to keep]. Add (from recent patterns): [new preferences/rules/lessons]. Privacy check: [confirm no credentials/financial/health/others' data → remove if found]. Maintenance habit: [a quick periodic review + add-a-line-as-you-go].

Quality Checks

  • Reviews the file against who the person actually is now
  • Prunes stale/redundant/resolved content
  • Sharpens vague statements into actionable ones
  • Resolves contradictory instructions
  • Adds missing recent patterns
  • Re-checks for sensitive data; sets a maintenance habit

Anti-Patterns

  • Only adding, never pruning (bloat).
  • Leaving contradictions that confuse the AI.
  • Vague rules that don't actually change behavior.
  • Letting sensitive data sit in an AI-readable file.
  • A one-time cleanup with no ongoing habit.

Example Trigger Phrases

  • "Review my CLAUDE.md — it feels outdated."
  • "Clean up my AI memory file, it's gotten bloated."
  • "My custom instructions aren't working well anymore — fix them."
  • "Maintain my MEMORY.md with how I've been working lately."
  • "My AI keeps getting me wrong — check my context file."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/memory-file-maintenance of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Memory File Maintenance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Memory File Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory File Maintenance this skillmohitagw15856/pm-claude-skills1.4k—~1.2kAutomated safety check: PassMIT
Using Agent Skillsaddyosmani/agent-skills103k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k18 repos~2.7kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    103k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed
  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 18 repos~2.7k tokens
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Memory File Maintenance

What does Memory File Maintenance do?

Keep your AI memory/context file (MEMORY.md, CLAUDE.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right. Memory File Maintenance is an agent skill from mohitagw15856/pm-claude-skills.md, custom instructions) healthy over time — pruning the stale, adding the new, and keeping it sharp so your AI keeps getting you right.

When should I use Memory File Maintenance?

Memory File Maintenance fits situations like: asked review my memory file; my AI context is outdated; clean up my CLAUDE.md; maintain my AI instructions.

How do I install Memory File Maintenance in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill memory-file-maintenance -a claude-code`. Or copy the skill folder (skills/memory-file-maintenance in mohitagw15856/pm-claude-skills) into .claude/skills/memory-file-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Memory File Maintenance in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill memory-file-maintenance -a codex`. Or copy the skill folder (skills/memory-file-maintenance in mohitagw15856/pm-claude-skills) into .agents/skills/memory-file-maintenance in your project. Codex loads it when a task matches its description.

Can I use Memory File Maintenance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill memory-file-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory-file-maintenance, .gemini/skills/memory-file-maintenance, .github/skills/memory-file-maintenance and .opencode/skills/memory-file-maintenance in your project.

What does Memory File Maintenance need to run?

SKILL.md names no scripts, command-line tools or credentials: Memory File Maintenance is instructions for the agent only.

Does Memory File Maintenance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Memory File Maintenance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Memory File Maintenance use?

Memory File Maintenance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Memory File Maintenance use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Memory File Maintenance?

Skills that share tags, products or a category with Memory File Maintenance: Using Agent Skills (addyosmani/agent-skills, 103k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Writing For Agents (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memory File Maintenance?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.