Agent skill

Memtrace Refactoring Guide

by syncable-dev in syncable-dev/memtrace-public

Build a phased, risk-scored refactoring plan from Memtrace complexity, dead-code, bridge, impact analysis, and Cortex decision-memory constraints.

Custom licenceAuto-check passedDevelopment

Install Memtrace Refactoring Guide

skills CLI
$ npx skills add syncable-dev/memtrace-public --skill memtrace-refactoring-guide -a claude-code

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

GitHub CLI
$ gh skill install syncable-dev/memtrace-public memtrace-refactoring-guide --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/syncable-dev/memtrace-public.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/memtrace-skills/skills/memtrace-refactoring-guide .claude/skills/memtrace-refactoring-guide && 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
memtrace-refactoring-guide
GitHub stars
486
Token cost
~1.6k tokens
SKILL.md length
733 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
Custom licence

At a glance

Build a phased, risk-scored refactoring plan from Memtrace complexity, dead-code, bridge, impact analysis, and Cortex decision-memory constraints.

  • Works in 7 steps: Identify refactoring candidates → Score candidates by volatility → Assess risk for top candidates → …
  • The user wants to refactor source code
  • SKILL.md covers Overview, Steps, Decision Points and Output, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memtrace Refactoring Guide is an agent skill from syncable-dev/memtrace-public. Build a phased, risk-scored refactoring plan from Memtrace complexity, dead-code, bridge, impact analysis, and Cortex decision-memory constraints. Use when the user wants to refactor source code, reduce complexity, clean technical debt, delete dead code, split large functions, extract modules, reorganize code, or choose refactoring priorities. Do not plan refactors from grep/manual reference search alone; check graph impact and decision rationale/bans/contracts before changing existing code.

Its SKILL.md is about 1.6k 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 Development, covering Refactoring. The repository describes itself as: Structural memory for AI coding agents. Bi-temporal graph, MCP-native, zero LLM calls. Cursor · Claude Code · Codex · DeepSeek Harness · Hermes · VS Code · Windsurf.

When your agent uses it

  • The user wants to refactor source code
  • Reduce complexity
  • Clean technical debt
  • Delete dead code

Example prompts

  • “/memtrace-refactoring-guide”

Workflow steps

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

  1. Identify refactoring candidates
  2. Score candidates by volatility
  3. Assess risk for top candidates
  4. Check decision memory before refactoring/removing
  5. Understand the neighbourhood
  6. Check community boundaries
  7. Produce the refactoring plan

What it can do on your machine

Read from SKILL.md and the folder at commit 3a3084d. 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

Memtrace Refactoring Guide loads about 1.6k tokens when it runs. Until then it costs about 131 tokens; SKILL.md has 733 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 733 words (~1,627 tokens).

“Guided refactoring workflow — identifies refactoring candidates using structural analysis, scores them by risk and priority, checks Cortex decision memory for rationale/bans/contracts, and produces a phased refactoring plan. Combines complexity metrics, dead code detection, bridge analysis, temporal evolution, and decision…”

— opening of SKILL.md by syncable-dev, Custom licence
name
memtrace-refactoring-guide

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/memtrace-skills/skills/memtrace-refactoring-guide of syncable-dev/memtrace-public.

Open the folder on GitHubat commit 3a3084d

Compare with similar skills

Memtrace Refactoring Guide 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.

Memtrace Refactoring Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memtrace Refactoring Guide this skillsyncable-dev/memtrace-public486—~1.6kAutomated safety check: PassCustom licence
Guidelinesakash-network/node1.1k22 repos~577Automated safety check: PassMIT
Component Refactoringlangflow-ai/langflow156k—~3.5kAutomated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman41k—~2.6kAutomated safety check: PassGPL-3.0
ast-grep Structural Searchcode-yeongyu/oh-my-openagent70k—~3.3kAutomated safety check: PassMIT
Systematic Code Refactoringluongnv89/claude-howto42k—~3kAutomated safety check: PassMIT

Similar skills

  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed
  • Component Refactoring

    langflow-ai/langflow

    Refactor high-complexity React components in Langflow frontend.

    156k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    41k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • ast-grep Structural Search

    code-yeongyu/oh-my-openagent

    Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.

    70k GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Codex

    skills-directory/skill-codex

    A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing

    1.5k GitHub starsUsed in 3 repos~1.8k tokens
    DevelopmentAuto-check passed

More from syncable-dev/memtrace-public

All 27 skills in this repo
  • Memtrace Change Impact Analysis

    syncable-dev/memtrace-public

    Compute what a planned source-code change will break — blast radius, affected processes, cross-repo callers, temporal stability, and Cortex decision-memory constraints — and produce a risk-rated…

    486 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Memtrace Cochange

    syncable-dev/memtrace-public

    Find files that historically co-change with a target symbol or file, ranked by co-occurrence across git episodes.

    486 GitHub stars~961 tokensUpdated yesterday
    Auto-check passed
  • Memtrace Code Review

    syncable-dev/memtrace-public

    Review GitHub pull requests with Memtrace's local graph-backed review engine.

    486 GitHub stars~818 tokensUpdated yesterday
    Auto-check passed
  • Memtrace Codebase Exploration

    syncable-dev/memtrace-public

    Map an indexed source-code repo into a structured overview — scale, communities, central symbols, execution flows, API surface, recent activity.

    486 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memtrace Continuous Memory

    syncable-dev/memtrace-public

    Keep the Memtrace index fresh while editing by watching a repo for live, incremental re-indexing.

    486 GitHub stars~645 tokensUpdated yesterday
    Auto-check passed
  • Memtrace Decision Memory

    syncable-dev/memtrace-public

    Use Cortex decision memory through the normal Memtrace MCP tools.

    486 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Memtrace Refactoring Guide

What does Memtrace Refactoring Guide do?

Build a phased, risk-scored refactoring plan from Memtrace complexity, dead-code, bridge, impact analysis, and Cortex decision-memory constraints. Memtrace Refactoring Guide is an agent skill from syncable-dev/memtrace-public. Build a phased, risk-scored refactoring plan from Memtrace complexity, dead-code, bridge, impact analysis, and Cortex decision-memory constraints.

When should I use Memtrace Refactoring Guide?

Memtrace Refactoring Guide fits situations like: the user wants to refactor source code; reduce complexity; clean technical debt; delete dead code.

How do I install Memtrace Refactoring Guide in Claude Code?

Run `npx skills add syncable-dev/memtrace-public --skill memtrace-refactoring-guide -a claude-code`. Or copy the skill folder (plugins/memtrace-skills/skills/memtrace-refactoring-guide in syncable-dev/memtrace-public) into .claude/skills/memtrace-refactoring-guide in your project. Claude Code loads it when a task matches its description.

How do I install Memtrace Refactoring Guide in Codex?

Run `npx skills add syncable-dev/memtrace-public --skill memtrace-refactoring-guide -a codex`. Or copy the skill folder (plugins/memtrace-skills/skills/memtrace-refactoring-guide in syncable-dev/memtrace-public) into .agents/skills/memtrace-refactoring-guide in your project. Codex loads it when a task matches its description.

Can I use Memtrace Refactoring Guide 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 syncable-dev/memtrace-public --skill memtrace-refactoring-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memtrace-refactoring-guide, .gemini/skills/memtrace-refactoring-guide, .github/skills/memtrace-refactoring-guide and .opencode/skills/memtrace-refactoring-guide in your project.

What does Memtrace Refactoring Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Memtrace Refactoring Guide is instructions for the agent only.

Does Memtrace Refactoring Guide 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 Memtrace Refactoring Guide 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 Memtrace Refactoring Guide use?

Memtrace Refactoring Guide has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Memtrace Refactoring Guide use?

About 1.6k tokens (SKILL.md is roughly 6.5k 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 Memtrace Refactoring Guide?

Skills that share tags, products or a category with Memtrace Refactoring Guide: Guidelines (akash-network/node, 1.1k stars), Component Refactoring (langflow-ai/langflow, 156k stars), Migrate Core Code to Submodules (tinyhumansai/openhuman, 41k stars) and ast-grep Structural Search (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memtrace Refactoring Guide?

syncable-dev (a GitHub organization) maintains it in syncable-dev/memtrace-public, which has 486 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 6, 2026.

Source: syncable-dev/memtrace-public on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.