ashlr-cost-refactor SKILL.md skillA

ashlr-cost-refactor from ashlrai/ashlr-plugin is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ashlrai/ashlr-plugin/ashlr-cost-refactor@git:20260601.33fc708

Pins git:20260601.33fc708 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ashlrai/ashlr-plugin
Path
skills/ashlr-cost-refactor/SKILL.md
Versions recorded
1
Latest version
git:20260601.33fc708, committed Jun 1, 2026
Size
2,785 bytes
Repository stars
3
License
MIT

Token-efficient refactoring discipline for Claude Code. Diff-first before editing, structural edits for renames, find-all-refs then one multi_edit per file, no re-reads between edits, one genome proposal at the end. Reduces refactor session cost 40–65%.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ashlr Cost Refactor

A structured discipline for refactoring tasks that minimizes token spend without sacrificing correctness.

## Rules (active when this skill is enabled)

### 1. Diff first
Before editing anything, run `ashlr__diff` or `ashlr__diff_semantic` to understand what already changed (staged/unstaged). This prevents redundant edits to files that are already in the state you want.

### 2. Structural edits for renames
When renaming a symbol, type, or file — use `ashlr__edit_structural` instead of search/replace. Structural edit finds all references in one pass and renames them correctly, including imports and re-exports.

### 3. Find all refs, then one `ashlr__multi_edit` per file
Before editing a file, run `ashlr__grep` to find all references. Then apply all changes to that file in a single `ashlr__multi_edit` call. Do not make sequential single edits to the same file — each one burns a full round-trip.

### 4. No re-reads between edits in a sequence
Once you've read a file and know its structure, proceed through your edit sequence without re-reading. `ashlr__edit` and `ashlr__multi_edit` return diffs that confirm each change — that's sufficient to continue.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ashlrai/ashlr-plugin/ashlr-cost-refactor@sha256:9fd216f24771a2f1

The line at the top of this page pins the label git:20260601.33fc708, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pg4zxxakvc3wslke.svg)](https://markdownregistry.com/a/art_pg4zxxakvc3wslke)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 1, 2026.

versioncommittedcommitsizeaudit
git:20260601.33fc708 latest2026-06-01 33fc708 2,785 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2785 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ashlrai/ashlr-plugin · 3 stars · license MIT · pushed 2026-10-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pg4zxxakvc3wslke
GET https://markdownregistry.com/api/v1/resolve?ref=ashlrai/ashlr-plugin/ashlr-cost-refactor
GET https://markdownregistry.com/api/v1/blob/9fd216f24771a2f114a8d55d436a998e616520addd069162e90e32c627f3cd74

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ashlrai/ashlr-plugin

AGENTS.md AGENTS.md file
ashlrai/ashlr-plugin · AGENTS.md
git:20261013.cc430cf · audit A · 3 stars
ashlr-brief SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-brief/SKILL.md · Tunable response-shortening skill for Claude Code. Trims filler from prose to reduce output tokens 30–55% while…
git:20260507.6675636 · audit A · 3 stars
ashlr-codex-doctor SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-codex-doctor/SKILL.md · Check Ashlr's Codex plugin packaging, MCP manifest, hooks, skills, and workspace allow-list. Use when Codex setup…
git:20260930.b984bba · audit A · 3 stars
ashlr-codex-efficient-tools SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-codex-efficient-tools/SKILL.md · Codex-native efficient tool workflow. Prefer Ashlr MCP read, grep, tree, bash, savings, and genome tools before native…
git:20260930.b984bba · audit A · 3 stars
ashlr-codex-genome-refresh SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-codex-genome-refresh/SKILL.md · Refresh or maintain Ashlr project genome state from Codex. Use after architectural changes, schema/routing changes, or…
git:20260930.b984bba · audit A · 3 stars
ashlr-codex-parallel-explore SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-codex-parallel-explore/SKILL.md · Efficient parallel exploration habits for Codex. Use when a task needs several independent codebase questions answered…
git:20260930.b984bba · audit A · 3 stars
ashlr-codex-savings SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-codex-savings/SKILL.md · Inspect Ashlr token savings from Codex using host-neutral CLI and MCP surfaces.
git:20260930.b984bba · audit A · 3 stars
ashlr-efficient SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-efficient/SKILL.md · Output structure reshaper for Claude Code. Complements ashlr-brief's prose trimming by enforcing inverted-pyramid…
git:20260601.33fc708 · audit A · 3 stars
ashlr-genome-author SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-genome-author/SKILL.md · Guidelines for when and how to call ashlr__genome_propose to keep the project genome accurate. Covers…
git:20260601.33fc708 · audit A · 3 stars
ashlr-lean-tools SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-lean-tools/SKILL.md · Highest-impact token-saving habits for Claude Code tool use. Read-once, batch edits, orient-before-search, skip…
git:20260601.33fc708 · audit A · 3 stars
ashlr-search SKILL.md skill
ashlrai/ashlr-plugin · skills/ashlr-search/SKILL.md · Genome-aware search habits for Claude Code. Prefer ashlr__grep and ashlr__glob over native scans; compose multi-term…
git:20260601.33fc708 · audit A · 3 stars

Every file in ashlrai/ashlr-plugin

Browse by kind, by grade A, or by owner.