Tooluck logoTooluck
SKILL.md

refactor

Agent skill fromagenticnotetaking/arscontexta

Plan vault restructuring from config changes. Compares config.yaml against derivation.md, identifies dimension shifts, shows restructuring plan, executes on approval. Triggers on "/refactor", "restructure vault".

How to install refactor

install refactor
# install the arscontexta pack with the skills CLI
npx skills add agenticnotetaking/arscontexta

# or add only this skill to Claude Code: copy the folder

skill-sources/refactor/

# into

~/.claude/skills/refactor/ (all projects)

.claude/skills/refactor/ (one project)

skill-sources/refactor/SKILL.md

MITFull file
1## Runtime Configuration (Step 0 — before any processing)
2
3Read these files to configure domain-specific behavior:
4
51. **`ops/derivation-manifest.md`** — vocabulary mapping, dimension positions, platform hints
6 - Use `vocabulary.notes` for the notes folder name
7 - Use `vocabulary.note` / `vocabulary.note_plural` for note type references
8 - Use `vocabulary.topic_map` / `vocabulary.topic_map_plural` for MOC references
9 - Use `vocabulary.inbox` for the inbox folder name
10
112. **`ops/config.yaml`** — current live configuration (the "after" state)
12
133. **`ops/derivation.md`** — original derivation record (the "before" state)
14
15If these files don't exist, report error: "Cannot refactor without both ops/config.yaml and ops/derivation.md. These files establish the baseline and current configuration."
16
17---
18
19## EXECUTE NOW
20
21**INVARIANT: /refactor never executes without approval.** The plan is always shown first.
22
23**Target: $ARGUMENTS**
24
25Parse immediately:
26- If target is empty: detect ALL config changes and plan restructuring
27- If target names a specific dimension (e.g., "granularity", "organization"): focus on that dimension only
28- If target is `--dry-run`: show plan without asking for approval
29
30**Execute these phases:**
31
321. Detect changes between config.yaml and derivation.md
332. Plan restructuring for each changed dimension
343. Show the plan with affected artifacts and risk assessment
354. Execute on approval (unless --dry-run)
365. Validate post-restructuring
37…

Excerpt shown under the repository's MIT license.

More skills in arscontexta

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates