One-click install
npx skills add https://github.com/raintree-technology/agent-starter --skill cleanup-slop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup-slop
Source: https://github.com/raintree-technology/agent-starter/tree/main/templates/.claude/skills/cleanup-slop
Command: npx skills add https://github.com/raintree-technology/agent-starter --skill cleanup-slop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill efficiently cleans up AI-generated or redundant comments from code, preserving valuable information while maintaining the original code logic.

Core Features & Use Cases

  • Selective Comment Removal: Removes specific types of comments based on predefined patterns (e.g., AI-generated slop, in-motion narration, restated code).
  • Preservation of Valuable Comments: Keeps important comments such as workarounds, invariants, and references to specifications.
  • Code Safety: Never alters code logic; operates solely on comments to ensure code functionality remains intact.
  • Use Case: After AI-generated code review, use this Skill to strip out unnecessary comments, making the code more readable and maintainable.

Quick Start

Run the cleanup-slop skill with a specific file path to remove AI-generated slop: 'cleanup-slop --path ./codebase/feature-a'

Frequently Asked Questions about cleanup-slop

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

FAQPage Schema
How do I remove AI-generated comments from my code without changing logic?

To remove AI-generated comments without altering logic, use pattern matching and heuristics that strip redundant comments while preserving code functionality and high-value annotations like workarounds or invariants.

What is AI-generated slop in a codebase and how do I clean it up?

AI-generated slop refers to redundant or narrative comments added during AI-assisted coding. Cleanup involves selectively removing these comments based on predefined patterns while keeping comments with high informational value intact.

How do I strip restated code comments from files after an AI code review?

Stripping restated code comments after an AI review requires running a targeted cleanup script on your codebase path. The process removes in-motion narration and restated code comments, ensuring the original code logic remains completely unaltered.

Does comment removal affect code functionality or break existing logic?

Comment removal does not affect code functionality because the cleanup process operates solely on comments. It never alters code logic, ensuring your codebase functions exactly as before while improving overall code readability and maintainability.

What types of comments are preserved during AI slop cleanup?

During AI slop cleanup, comments with high informational value are preserved. This includes important annotations such as workarounds, invariants, and references to specifications, ensuring critical context is maintained while redundant comments are removed.

Can I clean up AI slop from a specific directory path in my project?

Yes, you can clean up AI slop from a specific directory path by running the cleanup script with a targeted file path argument. This allows you to surgically remove unnecessary comments from specific codebase sections like feature folders.