Deslop

SkillDev tools

Lets your agent clean up bloated prose, code or interfaces with the deslop skill, keeping meaning intact.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Deslop skill

About this skill

Clean up the prose, code or interface already in scope, protect its meaning, voice and behaviour, remove what only adds reading work, and return findings instead of edits when a review was asked for.

What this skill tells your AI

The instructions your AI receives, as published by automagik-dev/genie in skills/deslop/SKILL.md and read by ahel’s review.

Reduce the work of reading, maintaining and safely changing what is in front of you, without losing what it guarantees. Lines, sentences, files, wrappers, dependencies and tests have no target count, and a pass that changes nothing is a valid result.

Bound the scope

The subject is what the request already names: this draft, this document, this diff, the code just touched and the callers it reaches. A repository-wide sweep is separate work with its own request. Ordinary drafting and ordinary implementation include checking what you touch; neither authorizes unrelated cleanup, and neither reopens a decision the caller already made.

Name the mode in one line before the first change, and take the narrowest mode the request supports:

ModeYou returnDone when
Draft or implementThe artifactThe requested scope is covered and its own checks pass
CleanupThe edited artifact and what changedEvery change names a benefit, and every protected invariant still holds
ReviewFindings, nothing editedEvery finding carries a location, the burden it imposes, and the smallest useful fix

A request to look at something is a review. Rewriting on a review request destroys the evidence the caller asked for.

Protect before you remove

List what must survive before proposing a single removal, and keep the list where the caller can read it.

In prose, protect names, quantities, claims, citations, requirements and causal links, along with the author's stance and degree of certainty. In code, protect the requested behaviour, the existing contracts, and whatever an apparently redundant construct is there to defend.

Removing something whose purpose you cannot state is a guess wearing a diff. When the reason for a construct stays unclear after you have looked for it, the honest output is a low-confidence finding, not a deletion.

Tells are clues, never quotas

The references below name what tends to signal avoidable work. Each one is a reason to look, never a verdict. A contrast may explain a real distinction, passive voice may focus on the right subject, an adverb may qualify a claim, and an extra layer may hold a boundary. Judge the instance in front of you.

No deletion quota, no detector score, no punctuation ban, no compulsory stylistic change. Swapping one stock phrase for another, or chopping prose and flattening call graphs so the work looks done, fails the same way the original did.

The three parts

Load only the part the request needs:

  • references/writing.md — prose: messages, documents, reports, copy, pull request bodies.
  • references/code.md — code: the touched implementation, its callers and its tests.
  • references/design.md — interfaces, only for a project that has one: the rendered screen, its states, and the tokens and components behind it.

Prose judged against the live product belongs to the docs skill, a prompt to refine, a skill to authoring. A blocking review gap is repair work for the fix skill, not for this one.

Before you stop

Read the result once against the original. In prose, check numbers, named entities, degree of certainty and who said what. In code, run the checks that actually cover the changed behaviour and quote their exit codes.

Report what changed, the benefit each change bought, the checks you ran, and what you deliberately left alone and why. Never argue a change from the size of the diff: a shorter diff is not evidence of performance, correctness, or saved effort. Stop when the artifact serves its purpose instead of polishing it into a different voice or a different architecture.

Signals

GitHub stars
343
Forks
53
Last commit
Sep 2026
Advanced
Item type
skill
Key
deslop-automagik-dev
Source
github.com/automagik-dev/genie