Refactor

by agenticnotetaking

Refactor is an Automation skill for Claude Code, published by agenticnotetaking in arscontexta.

3.5K stars219 forkson agenticnotetaking/arscontextaAdded 2026/08/16Repository updated 2026/02/24

View source on GitHub Download repo ZIP

claude-codeclaude-code-pluginknowledge-baseknowledge-managementmarkdownsecond-brain

Install in seconds

Install Refactor

Copy Refactor into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/agenticnotetaking/arscontexta/tree/main/skill-sources/refactor ~/.claude/skills/refactor

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/agenticnotetaking/arscontexta.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skill-sources/refactor/SKILL.md in agenticnotetaking/arscontexta
Installs to: ~/.claude/skills/refactor
Collection: One of 25 skills cataloged from this repository
Category: Automation — 1523 skills

What Refactor does

Refactor plans vault restructuring from configuration changes by comparing ops/config.yaml against ops/derivation.md, identifies dimension shifts, and shows a restructuring plan before executing on approval.

Refactor is cataloged under Automation on DirSkills. Refactor comes from a repository tagged claude-code, claude-code-plugin, knowledge-base, knowledge-management and markdown.

Documentation

README

Excerpt

Runtime Configuration (Step 0 — before any processing)

Read these files to configure domain-specific behavior:

ops/derivation-manifest.md — vocabulary mapping, dimension positions, platform hints
- Use vocabulary.notes for the notes folder name
- Use vocabulary.note / vocabulary.note_plural for note type references
- Use vocabulary.topic_map / vocabulary.topic_map_plural for MOC references
- Use vocabulary.inbox for the inbox folder name
ops/config.yaml — current live configuration (the "after" state)
ops/derivation.md — original derivation record (the "before" state)

This is the opening of the README. Read the full README on GitHub.

Commands Refactor provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/refactor
/architect
/reduce
/reflect
/health
/validate
/verify
/reweave
/ralph
/pipeline
/setup

Frequently asked about Refactor

What else does agenticnotetaking publish alongside Refactor?
Refactor is one of 25 skills that DirSkills catalogs from agenticnotetaking/arscontexta, the repository it ships in. Its siblings there include Add Domain, Ars Contexta Setup and Ars Contexta Tutorial. Each one is a separate skill with its own page in this directory, installs the same way Refactor does, and is maintained by agenticnotetaking in that same repository. The rest of the collection is listed on the agenticnotetaking/arscontexta page.
How does Refactor compare to other Automation skills?
Refactor ranks #347 by stars among the 1523 Automation skills in this catalog. The most-starred ones next to it are Autonomous Loops, Autonomous Agent Harness and Automation Audit Ops. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Refactor against them. Open each page to compare what they document and how they install.