Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/weavatrix/weavatrix-refactor/skillnpx skills add Weavatrix/weavatrix-refactor --skill skillgit clone --depth 1 https://github.com/Weavatrix/weavatrix-refactorWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00083 | $0.00412 |
| Opus 5 | $0.00042 | $0.00206 |
| Sonnet 5 | $0.00017 | $0.00082 |
| Haiku 4.5 | $0.00008 | $0.00041 |
Grade A, and why
weavatrix-refactor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
100% identical to weavatrix-refactor — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
What it actually says
Weavatrix Refactor
Use this extension on demand after the target symbol, file, or change is clear.
The plugin exposes only 11 refactor methods; use the separate weavatrix
skill for the 43 read-only repository-intelligence methods.
Workflow
- Identify an exact symbol or bounded target. Use Weavatrix core first when cross-file graph evidence is needed.
- Call the narrowest Refactor method in its default preview/planning mode.
- Review exact files, hashes, edits, completeness, warnings, and
uncertainReferences. - Apply only when the user requested the source change and the plan matches
that request. Repeat the identical operation with
mode:"apply"and its single-useconfirm_token. - Run repository-native formatting and tests. Use
rollback_last_applyif the applied transaction must be reverted before files drift.
Read references/tool-routing.md to choose a method, then open only that method's card.
Safety
- Installing the plugin opens the process write gate, but no edit can apply without a matching preview token.
PARTIAL,UNPROVEN, uncertain references, and advisory move results are review states, not permission to guess.- Never invent a symbol id, silently broaden a selected occurrence set, or convert an advisory plan into an automatic source write.
- Rollback is all-or-nothing and refuses post-apply drift.
What ships with it
12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/tool-routing.md 1.2 KB
- references/tools/apply_edit_plan.md 933 B
- references/tools/bulk_replace.md 930 B
- references/tools/change_signature.md 804 B
- references/tools/delete_readiness.md 700 B
- references/tools/edit_symbol.md 913 B
- references/tools/move_file.md 757 B
- references/tools/move_symbol.md 730 B
- references/tools/organize_imports.md 679 B
- references/tools/rename_related_symbols.md 1.0 KB
- references/tools/rename_symbol.md 1.1 KB
- references/tools/rollback_last_apply.md 617 B
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 43 lines · 83 tokens per session scan A 94b511091a08
weavatrix-refactor is a skill published in the GitHub repository Weavatrix/weavatrix-refactor (1 stars, last pushed 8d ago), licensed MIT. It adds 83 tokens to every session and 412 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to weavatrix-refactor, differing in 0 lines, and is treated as a copy.
Other skills, from other repositories
weavatrix-refactor-js
Apply hash-verified refactoring edit plans: a weavatrix-refactor-js plan producer computes and proves a plan against the read-only core, then applyeditplan previews it (issuing a confirm token), applies with automatic rollback, and verifiedchange proves it. The only Weavatrix component that writes code.
tbd
Git-native issue tracking (beads), coding guidelines, knowledge injection, and spec-driven planning for AI agents. Drop-in replacement for bd/Beads with simpler architecture. Use for: tracking issues/beads with dependencies, creating bugs/features/tasks, planning specs, implementing features from specs, code reviews…
software-code-refactoring
Improve production code quality while preserving all existing test behavior. Commonly used for the Refactor phase of TDD red-green-refactor, but applicable to any codebase with tests. Use when production code works but needs cleanup — reducing duplication, improving naming, simplifying complexity, aligning with…
simplify-codebase
Simplification audit or authorized codebase simplification whose stated objective is to remove accidental complexity. Use for evidence-backed deletion or consolidation of dead code, duplicate state, redundant APIs or layers, ownerless abstractions, obsolete compatibility or design records, and over-engineering in any…
flowmark
Fast, consistent Markdown auto-formatter for typographic cleanup, normalization, and clean semantic line breaks. Use when creating, editing, or cleaning Markdown; formatting LLM-generated docs; adopting Flowmark in a repository; adding Markdown format scripts or commit hooks; or replacing Prettier or another Markdown…
cyclomatic-complexity
Refactor code to reduce cyclomatic complexity so it stays readable, maintainable, and aligned with the long-term vision of the codebase, not just optimized for AI comprehension. Use whenever the user asks to refactor, simplify, clean up, or review code quality; mentions complexity, maintainability, readability…