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.