reslop

Rewrite docstrings and comments with code-grounded factual descriptions.

Updated May 2, 2026
One-click install
npx skills add https://github.com/ajbarea/techne --skill reslop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reslop
Source: https://github.com/ajbarea/techne/tree/main/plugins/techne/skills/reslop
Command: npx skills add https://github.com/ajbarea/techne --skill reslop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Replaces overhyped, repetitive, or hallucinated docstrings and comments with short, factual descriptions grounded in the repository’s actual implementation, call sites, and tests.

Core Features & Use Cases

  • Code-grounded rewrites: Reads the implementation, finds call sites, and checks adjacent tests before proposing replacements.
  • Hate-word and quantitative-claim guardrails: Avoids reintroducing slop and prevents unsupported performance or numeric assertions unless grounded by injected context.
  • Scoped edits: Defaults to user-provided scope (or pending-change files when asked to rewrite “in my changes”) to avoid touching unrelated files.
  • Diff-first workflow: Produces old→new diffs grouped by file and asks you to apply selected or all changes.

Quick Start

Run techne:reslop on the paths or files you want to clean up, then apply the proposed docstring/comment diffs.

Frequently Asked Questions about reslop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rewrite inaccurate docstrings to match actual code behavior?

To rewrite inaccurate docstrings, the tool reads implementations, greps call sites, and checks adjacent tests to replace overhyped descriptions with factual, code-grounded statements. It produces safe old-to-new diffs without inventing behavior or performance metrics.

What is codebase alignment for repo hygiene and how does it handle comments?

Codebase alignment for repo hygiene replaces hallucinated or repetitive comments with short, factual descriptions grounded in the repository's actual implementation. It targets specific file scopes or pending-change files to avoid touching unrelated code.

Can I clean up slop docstrings only in my pending changes without affecting the whole repo?

Yes, you can clean up slop docstrings in pending changes by providing a targeted scope or asking to rewrite within your modifications. This confines edits to specified paths or pending-change files, preventing unrelated repository files from being touched.

Does docstring rewriting remove unsupported quantitative claims and hate-words?

Docstring rewriting removes unsupported quantitative claims and hate-words by applying guardrails that prevent reintroducing slop. It blocks unsupported performance or numeric assertions unless explicitly grounded by injected context from tests or implementation.

What is the best way to generate safe diffs for comment rewriting across a codebase?

The best way to generate safe diffs for comment rewriting is a diff-first workflow that groups old-to-new changes by file. It requires consulting implementation and test invariants before proposing replacements, letting you apply selected or all changes safely.

When should I not use automated docstring cleanup on my repository?

You should not use automated docstring cleanup when your repository lacks sufficient test coverage or call sites to verify invariants. The tool avoids inventing behavior or performance metrics and requires grounding in actual implementation to produce safe replacements.