ai-smell-review

Scan and refactor code to remove AI-generated patterns for human readability.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Objective-Arts/lens-dist --skill ai-smell-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-smell-review
Source: https://github.com/Objective-Arts/lens-dist/tree/main/skills/ai-smell-review
Command: npx skills add https://github.com/Objective-Arts/lens-dist --skill ai-smell-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of AI-generated code that often contains "code smells" – patterns that make it look unnatural, overly complex, or inefficient, hindering readability and maintainability.

Core Features & Use Cases

  • AI Smell Detection: Identifies common AI-generated code patterns like over-abstraction, defensive paranoia, comment spam, speculative features, and verbose naming.
  • Code Refinement: Automatically removes or simplifies these identified smells to make the code appear human-written and more idiomatic.
  • Use Case: After an AI assistant generates a significant portion of your codebase, run this Skill to clean up the output, ensuring it adheres to best practices and human coding standards before merging.

Quick Start

Run the ai-smell-review skill on the current directory to clean up AI-generated code.

Frequently Asked Questions about ai-smell-review

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

FAQPage Schema
How do I refactor AI-generated code to make it look human-written?▼

To make AI-generated code human-written, you must remove unnatural patterns like over-abstraction and comment spam. This skill scans your codebase to identify and correct these specific AI smells, ensuring idiomatic readability.

What are common AI code smells that hurt readability?▼

Common AI code smells include over-abstraction, defensive paranoia, comment spam, speculative features, and verbose naming. These patterns create excessive structure and complexity, which severely hinders code readability and long-term maintainability.

How do I clean up code after generating it with an AI assistant?▼

To clean up code after generating it with an AI assistant, run a refactoring scan on the current directory. This process removes speculative features and verbose naming, ensuring the output adheres to human coding standards before merging.

Can I use this to remove over-abstraction and excessive structure from my codebase?▼

Yes, you can use this to remove over-abstraction and excessive structure from your codebase. It specifically targets these defensive paranoia patterns and automatically simplifies them to ensure your code quality and maintainability.

When should I run an AI code smell review on my project?▼

You should run an AI code smell review after an AI assistant generates a significant portion of your codebase. This cleanup step ensures the output adheres to best practices and human coding standards before you merge the changes.