efficiency-optimizer_skill

Overview

This skill analyzes recent Python code changes to find performance and efficiency improvements. It focuses on practical, high-impact optimizations that preserve readability and maintainability. The output is a prioritized set of findings documented with location, impact, and concrete code examples.

How this skill works

The skill inspects only newly added or modified files or diff ranges and searches for common efficiency issues: algorithmic complexity, redundant work, memory and I/O patterns, inefficient database access, and missed caching opportunities. For each issue it generates a clear entry describing the problem, performance impact, a suggested fix with example code, and trade-offs. Findings are appended to a project file (specs/general/TECH-IMPROVEMENTS.md) so teams have a concise, actionable backlog of improvements.

When to use it

• After a feature branch or pull request is ready for review
• When performance regressions appear in tests or production
• Before a release where latency or cost matters
• When code introduces heavy loops, large memory usage, or frequent I/O
• During scheduled performance audits of recent work

Best practices

• Limit scope to recent changes unless a full audit is requested
• Prioritize fixes that yield measurable gains (profiling or complexity analysis)
• Avoid micro-optimizations that harm clarity without material benefit
• Provide code examples and note trade-offs so maintainers can accept or defer changes
• Prefer idiomatic Python solutions and respect existing project patterns

Example use cases

• Detecting an O(n²) loop introduced in a new feature and suggesting an O(n log n) approach
• Identifying repeated database queries in a request handler and recommending batched queries or joins
• Finding redundant data transformations and replacing them with a single, streamed pipeline
• Spotting memory spikes from building large lists and proposing generators or incremental processing
• Recommending memoization or caching for expensive pure functions used frequently