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.