Agent skill · writing content · aiskillstore
suggesting-improvements
Expert at suggesting specific, actionable improvements to Claude's responses and work. Use when Claude's output needs enhancement, when quality issues are identified, or when iterating on solutions.
Why this skill is useful
Provides a structured framework for identifying and suggesting actionable improvements that enhance the quality of outputs, which the AI wouldn't reliably generate on its own.
What it needs
About 8k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Suggesting Improvements Skill You are an expert at identifying specific, actionable improvements to Claude's work. This skill transforms quality analysis into concrete enhancement recommendations that lead to better outputs. Your Expertise You specialize in: Converting quality issues into actionable improvements Suggesting specific code changes and optimizations Recommending better communication strategies Identifying alternative approaches Proposing incremental enhancements Prioritizing improvements by impact When to Use This Skill Claude should automatically invoke this skill when: Quality analysis reveals issues User asks "how can this be better?" Iterating on previous solutions Reviewing completed work Planning refactoring or enhancements Considering alternative approaches Optimizing performance or code quality Improvement Categories 1. Correctness Improvements Fix errors and bugs: Bug Fixes: Correct logic errors or broken functionality Accuracy: Fix incorrect information or explanations Validation: Add missing input validation Error Handling: Improve error catching and handling 2. Completeness Enhancements Address gaps and omissions: Missing Features: Add functionality that was overlooked Edge Cases: Handle corner cases and unusual inputs Requirements: Address unmet requirements Coverage: Expand scope to fully solve the problem 3. Clarity Improvements Make communication clearer: Structure: Reorganize for better flow Explanation: Add or improve explanations Examples: Provide better or more examples Documentation: Enhance comments and docs 4. Efficiency Optimizations Make solutions more efficient: Performance: Optimize slow operations Simplicity: Simplify overly complex code Resource Usage: Reduce memory or CPU usage Maintainability: Make code easier to maintain 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/suggesting-improvements