Skills for Real Engineers. Straight from my .agents directory.
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
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)
1## Runtime Configuration (Step 0 — before any processing)23Read these files to configure domain-specific behavior:451. **`ops/derivation-manifest.md`** — vocabulary mapping, dimension positions, platform hints6 - Use `vocabulary.notes` for the notes folder name7 - Use `vocabulary.note` / `vocabulary.note_plural` for note type references8 - Use `vocabulary.topic_map` / `vocabulary.topic_map_plural` for MOC references9 - Use `vocabulary.inbox` for the inbox folder name10112. **`ops/config.yaml`** — current live configuration (the "after" state)12133. **`ops/derivation.md`** — original derivation record (the "before" state)1415If 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."1617---1819## EXECUTE NOW2021**INVARIANT: /refactor never executes without approval.** The plan is always shown first.2223**Target: $ARGUMENTS**2425Parse immediately:26- If target is empty: detect ALL config changes and plan restructuring27- If target names a specific dimension (e.g., "granularity", "organization"): focus on that dimension only28- If target is `--dry-run`: show plan without asking for approval2930**Execute these phases:**31321. Detect changes between config.yaml and derivation.md332. Plan restructuring for each changed dimension343. Show the plan with affected artifacts and risk assessment354. Execute on approval (unless --dry-run)365. Validate post-restructuring37…
Excerpt shown under the repository's MIT license.
More skills in arscontexta
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
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
