ai-smell-scan

Scan codebases for AI-generated code smells and calculate a weighted index.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies patterns in code that are characteristic of AI generation, helping to maintain code quality and human readability.

Core Features & Use Cases

  • AI Smell Detection: Scans code for common AI-generated code smells like over-abstraction, comment spam, and excessive structure.
  • Index Calculation: Provides an "AI Smell Index" to quantify the level of AI-generated patterns.
  • Use Case: After an AI model has refactored a codebase, run this scan to assess the impact on code quality and identify areas that may require human review and cleanup.

Quick Start

Run the ai-smell-scan skill on the 'src/' directory.

Frequently Asked Questions about ai-smell-scan

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

FAQPage Schema
How do I detect AI-generated code smells in my codebase?

You can detect AI-generated code smells by scanning code files to identify and quantify patterns like over-abstraction, comment spam, and verbose naming, providing a weighted index of detected issues for code review.

What are common AI code smells I should look for during a code review?

Common AI code smells include over-abstraction, defensive paranoia, comment spam, speculative features, enterprise patterns, generic wrappers, verbose naming, and excessive structure, all of which degrade human readability and code quality.

How do I check code quality after an AI model refactors my code?

Check code quality after an AI refactor by running a scan to calculate an AI Smell Index, which quantifies the level of AI-generated patterns to identify areas requiring human review and cleanup.

How do I quantify the impact of AI refactoring on code readability?

Quantify the impact by calculating an AI Smell Index, which analyzes your codebase to provide a weighted measurement of detected AI-generated patterns and excessive structures that reduce human readability.

Can I scan a specific directory for over-abstraction and comment spam?

Yes, you can run a scan on a specific directory like 'src/' to analyze code files for targeted smell types including over-abstraction, comment spam, and generic wrappers, returning a quantified index of these patterns.

What is an AI Smell Index and how does it work?

An AI Smell Index is a metric that quantifies the level of AI-generated patterns in code by analyzing files for specific smell types, calculating a weighted score to indicate where human review is needed.