Agent skill

Memory Manage

by catlog22 in catlog22/Claude-Code-Workflow

Unified memory management - CLAUDE.md updates and documentation generation with interactive routing.

MITAuto-check: notesAgent Workflows

Install Memory Manage

skills CLI
$ npx skills add catlog22/Claude-Code-Workflow --skill memory-manage -a claude-code

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

GitHub CLI
$ gh skill install catlog22/Claude-Code-Workflow memory-manage --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/catlog22/Claude-Code-Workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/memory-manage .claude/skills/memory-manage && 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-manage
GitHub stars
2.1k
Token cost
~1.7k tokens
SKILL.md length
402 words
Files
6
Skills in repo
82
Repo updated
First seen
Licence
MIT

At a glance

Unified memory management - CLAUDE.md updates and documentation generation with interactive routing.

  • Works in 3 steps: Parse Input & Route → Interactive Needs Assessment → Execute Selected Phase
  • Tasks that involve Agent instruction files
  • SKILL.md covers Architecture Overview, Execution Flow, Shared Configuration and Core Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memory Manage is an agent skill from catlog22/Claude-Code-Workflow. Unified memory management - CLAUDE.md updates and documentation generation with interactive routing. Triggers on "memory manage", "update claude", "update memory", "generate docs", "更新记忆", "生成文档".

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `phases/01-update-full.md`, `phases/02-update-related.md` and `phases/03-update-single.md`).

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: JSON-driven multi-agent cadence-team development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution. The licence is MIT.

When your agent uses it

  • Tasks that involve Agent instruction files

Example prompts

  • “memory manage”
  • “update claude”
  • “update memory”
  • “/memory-manage”

Requirements

  • Pre-approved tools (allowed-tools): Agent(*), Bash(*), AskUserQuestion(*), Read(*)

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Parse Input & Route
  2. Interactive Needs Assessment
  3. Execute Selected Phase

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Agent(*)
    • Bash(*)
    • AskUserQuestion(*)
    • Read(*)

    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 Manage loads about 1.7k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 402 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Agent(*), Bash(*), AskUserQuestion(*), Read(*)

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 catlog22/Claude-Code-Workflow at commit 07491b0, republished under its MIT licence (© catlog22). 402 words, ~1,712 tokens.

Download SKILL.mdSave it as .claude/skills/memory-manage/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
memory-manage
description
Unified memory management - CLAUDE.md updates and documentation generation with interactive routing. Triggers on "memory manage", "update claude", "update memory", "generate docs", "更新记忆", "生成文档".
allowed-tools
Agent(*), Bash(*), AskUserQuestion(*), Read(*)

Memory Management Skill

Unified entry point for project memory (CLAUDE.md) updates and documentation (API.md/README.md) generation. Routes to specialized sub-commands via arguments or interactive needs assessment.

Architecture Overview

┌──────────────────────────────────────────────────────┐
│  Memory Manage (Router)                               │
│  → Parse input → Detect mode → Route to phase         │
└───────────────┬──────────────────────────────────────┘
                │
        ┌───────┴───────┐
        ↓               ↓
  ┌───────────┐   ┌───────────┐
  │ CLAUDE.md │   │  Docs     │
  │  管理     │   │  生成     │
  └─────┬─────┘   └─────┬─────┘
        │               │
   ┌────┼────┐     ┌────┴────┐
   ↓    ↓    ↓     ↓         ↓
 Full Related Single Full  Related
 全量  增量   单模块  全量    增量

Execution Flow

Step 1: Parse Input & Route

Detect execution mode from user input:

Auto-Route Rules (priority order):

SignalRouteExamples
Explicit sub-command token→ Direct dispatchupdate-full --tool qwen
Keyword: full, 全量, all, entire + update/claude→ update-full"全量更新claude"
Keyword: related, changed, 增量, diff + update/claude→ update-related"更新变更模块"
Keyword: single, module, 单模块 + path-like token→ update-single"更新 src/auth 模块"
Keyword: docs, documentation, 文档 + full/all/全量→ docs-full"全量生成文档"
Keyword: docs, documentation, 文档 + related/changed/增量→ docs-related"增量生成文档"
Ambiguous or no arguments→ AskUserQuestion/memory-manage

Valid sub-command tokens: update-full, update-related, update-single, docs-full, docs-related

Direct dispatch examples:

input = "update-full --tool qwen"
  → subcommand = "update-full", remainingArgs = "--tool qwen"
  → Read phases/01-update-full.md, execute

input = "update-single src/auth --tool gemini"
  → subcommand = "update-single", remainingArgs = "src/auth --tool gemini"
  → Read phases/03-update-single.md, execute

When ambiguous or no arguments, proceed to Step 2.

Step 2: Interactive Needs Assessment

Q1 — 确定内容类别:

AskUserQuestion({
  questions: [{
    question: "你要管理哪类内容?",
    header: "类别",
    multiSelect: false,
    options: [
      {
        label: "CLAUDE.md (项目记忆)",
        description: "更新模块指令文件,帮助Claude理解代码库结构和约定"
      },
      {
        label: "项目文档 (API+README)",
        description: "生成API.md和README.md到.workflow/docs/目录"
      }
    ]
  }]
})

Q2a — CLAUDE.md 管理范围 (用户选了 CLAUDE.md):

AskUserQuestion({
  questions: [{
    question: "CLAUDE.md 更新范围?",
    header: "范围",
    multiSelect: false,
    options: [
      {
        label: "增量更新 (Recommended)",
        description: "仅更新git变更模块及其父级,日常开发首选"
      },
      {
        label: "全量更新",
        description: "更新所有模块,3层架构bottom-up,适合重大重构后"
      },
      {
        label: "单模块更新",
        description: "指定一个模块,Explore深度分析后生成说明书式文档"
      }
    ]
  }]
})

Route mapping:

  • "增量更新" → update-related → Ref: phases/02-update-related.md
  • "全量更新" → update-full → Ref: phases/01-update-full.md
  • "单模块更新" → update-single → continue to Q3

Q2b — 文档生成范围 (用户选了项目文档):

AskUserQuestion({
  questions: [{
    question: "文档生成范围?",
    header: "范围",
    multiSelect: false,
    options: [
      {
        label: "增量生成 (Recommended)",
        description: "仅为git变更模块生成/更新文档,日常开发首选"
      },
      {
        label: "全量生成",
        description: "所有模块+项目级文档(ARCHITECTURE.md等),适合初始化"
      }
    ]
  }]
})

Route mapping:

  • "增量生成" → docs-related → Ref: phases/05-docs-related.md
  • "全量生成" → docs-full → Ref: phases/04-docs-full.md

Q3 — 补充路径 (仅 update-single 需要,且无路径参数时):

AskUserQuestion({
  questions: [{
    question: "请指定要更新的模块路径:",
    header: "路径",
    multiSelect: false,
    options: [
      {
        label: "src",
        description: "src 目录"
      },
      {
        label: ".",
        description: "项目根目录"
      }
    ]
  }]
})

用户可选 "Other" 输入自定义路径。

Step 3: Execute Selected Phase

Based on routing result, read and execute the corresponding phase:

Phase Reference Documents (read on-demand when phase executes):

ModeDocumentPurpose
update-fullphases/01-update-full.mdFull CLAUDE.md update, 3-layer architecture, batched agents
update-relatedphases/02-update-related.mdGit-changed CLAUDE.md update, depth-first
update-singlephases/03-update-single.mdSingle module CLAUDE.md, Explore + handbook style
docs-fullphases/04-docs-full.mdFull API.md + README.md generation
docs-relatedphases/05-docs-related.mdGit-changed docs generation, incremental

Shared Configuration

Tool Fallback Hierarchy

All sub-commands share the same fallback:

--tool gemini  →  [gemini, qwen, codex]  // default
--tool qwen    →  [qwen, gemini, codex]
--tool codex   →  [codex, gemini, qwen]
Show full SKILL.md (161 more words)Show less
Common Parameters
ParameterDescriptionDefaultUsed By
--tool <gemini|qwen|codex>Primary CLI toolgeminiAll
--path <dir>Target directory.update-full, docs-full
<path> (positional)Module path(required)update-single
Batching Thresholds
Sub-CommandDirect ExecutionAgent BatchBatch Size
update-full<20 modules≥20 modules4/agent
update-related<15 modules≥15 modules4/agent
update-singlealways singleN/A1
docs-full<20 modules≥20 modules4/agent
docs-related<15 modules≥15 modules4/agent

Core Rules

  1. Route before execute: Determine sub-command before any execution
  2. Phase doc is truth: All execution logic lives in phase docs, router only dispatches
  3. Read on-demand: Only read the selected phase doc, never load all
  4. Pass arguments through: Forward remaining args unchanged to sub-command
  5. User confirmation: Each sub-command handles its own plan presentation and y/n confirmation

Error Handling

ErrorResolution
Unknown sub-commandFall through to interactive flow
Phase doc not foundAbort with file path error
Missing path for update-singlePrompt via Q3
Sub-command execution failsFollow phase doc's own error handling

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

Files

SKILL.md and 5 other files in .claude/skills/memory-manage of catlog22/Claude-Code-Workflow.

  • SKILL.md
  • phases/01-update-full.md
  • phases/02-update-related.md
  • phases/03-update-single.md
  • phases/04-docs-full.md
  • phases/05-docs-related.md

Open the folder on GitHubat commit 07491b0

Compare with similar skills

Memory Manage 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 Manage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory Manage this skillcatlog22/Claude-Code-Workflow2.1k—~1.7kAutomated safety check: NotesMIT
Using Agent Skillsaddyosmani/agent-skills103k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k19 repos~2.7kAutomated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated 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
  • Writing For Agents

    bestofjs/bestofjs

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

    3.1k GitHub starsUsed in 19 repos~2.7k 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 7 days ago
    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 yesterday
    Agent WorkflowsAuto-check passed

More from catlog22/Claude-Code-Workflow

All 82 skills in this repo
  • Prompt Generator

    catlog22/Claude-Code-Workflow

    Generate or convert Claude Code prompt files — command orchestrators, skill files, agent role definitions, or style conversion of existing files.

    2.1k GitHub starsUsed in 1 repo~4.7k tokens
    Auto-check: notes
  • Ccw Help

    catlog22/Claude-Code-Workflow

    CCW command help system. An agent skill from catlog22/Claude-Code-Workflow.

    2.1k GitHub stars~2.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Team Ultra Analyze

    catlog22/Claude-Code-Workflow

    Deep collaborative analysis team skill. An agent skill from catlog22/Claude-Code-Workflow.

    2.1k GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check: notes
  • Brainstorm

    catlog22/Claude-Code-Workflow

    Unified brainstorming skill with dual-mode operation — auto mode (framework generation, parallel multi-role analysis, cross-role synthesis) and single role analysis.

    2.1k GitHub stars~4.8k tokensUpdated 3 mo ago
    Auto-check: notes
  • Ccw Chain

    catlog22/Claude-Code-Workflow

    Chain-based CCW workflow orchestrator. An agent skill from catlog22/Claude-Code-Workflow.

    2.1k GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check: notes
  • Delegation Check

    catlog22/Claude-Code-Workflow

    Check workflow delegation prompts against agent role definitions for content separation violations.

    2.1k GitHub stars~2.8k tokensUpdated 3 mo ago
    Auto-check: notes

Categories

Questions about Memory Manage

What does Memory Manage do?

Unified memory management - CLAUDE.md updates and documentation generation with interactive routing. Memory Manage is an agent skill from catlog22/Claude-Code-Workflow.md updates and documentation generation with interactive routing.

When should I use Memory Manage?

Memory Manage fits situations like: tasks that involve Agent instruction files.

How do I install Memory Manage in Claude Code?

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

How do I install Memory Manage in Codex?

Run `npx skills add catlog22/Claude-Code-Workflow --skill memory-manage -a codex`. Or copy the skill folder (.claude/skills/memory-manage in catlog22/Claude-Code-Workflow) into .agents/skills/memory-manage in your project. Codex loads it when a task matches its description.

Can I use Memory Manage 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 catlog22/Claude-Code-Workflow --skill memory-manage -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-manage, .gemini/skills/memory-manage, .github/skills/memory-manage and .opencode/skills/memory-manage in your project.

What does Memory Manage need to run?

SKILL.md names no scripts, command-line tools or credentials: Memory Manage is instructions for the agent only. Its frontmatter pre-approves these tools: Agent(*), Bash(*), AskUserQuestion(*), Read(*).

Does Memory Manage 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 Manage safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Memory Manage use?

Memory Manage 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 Manage use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Manage?

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

Who maintains Memory Manage?

catlog22 (a GitHub user) maintains it in catlog22/Claude-Code-Workflow, which has 2,130 GitHub stars. The repository holds 82 skills in this directory. The repository was last updated on June 18, 2026.

Source: catlog22/Claude-Code-Workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.