suggest

Analyzes codebases and applies safe, reversible improvement suggestions automatically.

35|3|Updated Jun 24, 2025
One-click install
npx skills add https://github.com/intelligentcode-ai/intelligent-claude-code --skill suggest-intelligentcode-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: suggest
Source: https://github.com/intelligentcode-ai/intelligent-claude-code/tree/main/src/skills/suggest
Command: npx skills add https://github.com/intelligentcode-ai/intelligent-claude-code --skill suggest-intelligentcode-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes code and provides context-aware improvement proposals and applies safe fixes automatically. It helps developers reduce refactoring churn and improve code quality with minimal manual effort.

Core Features & Use Cases

  • Auto-Implement Safe Improvements: automatically apply changes that are low-risk, beneficial, and reversible.
  • Maintainability & Readability Focus: rename unclear variables, extract duplicated logic, add docstrings, and remove dead code.
  • Guided Decision Flow: classify suggestions as auto-implementable or require human review.

Quick Start

Analyze a module and ask the skill to auto-refactor safe improvements. For example, request it to extract a duplicated block into a function and improve variable naming in the target file.

Frequently Asked Questions about suggest

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

FAQPage Schema
How do I automate code refactoring while ensuring changes are safe?

Automated code refactoring is applied safely by enforcing criteria: changes must be low effort, behavior-preserving, reversible, and provide measurable benefit. Proposals meeting these thresholds are auto-implemented, while complex modifications prompt for human review.

What is the best way to improve code maintainability and readability automatically?

Improving code maintainability automatically involves analyzing the codebase to generate context-aware proposals. It targets readability by renaming unclear variables, extracting duplicated logic into functions, adding docstrings, and removing dead code.

How does a guided decision flow work for automated code improvements?

A guided decision flow classifies improvement suggestions into auto-implementable or human-review categories. It evaluates safety criteria like low risk and reversibility, applying safe changes directly and prompting for human input on complex refactoring decisions.

Can I automatically remove dead code and extract duplicated logic from my modules?

Yes, you can automatically remove dead code and extract duplicated logic from modules. The skill analyzes the codebase to identify these maintainability issues and auto-applies the fixes when the changes are deemed low-risk and reversible.

When should I not use automated refactoring for my software project?

You should avoid automated refactoring when changes require high effort, alter behavior, or lack reversibility. Proposals failing the safety criteria are not auto-applied, ensuring risky modifications are deferred for manual human decision-making.

Does this automated improvement tool require any specific dependencies or frameworks?

No, the automated improvement tool requires no specific dependencies or frameworks. It operates across typical software projects by analyzing the codebase directly to generate and apply safe, maintainability-focused proposals.