Skip to content
Skillpedia
APIs & servers (backend)48k · #2066

max

Lets your agent improve existing code without changing what it does. It makes the code easier to read and maintain.

What it does

Max is an AI assistant that cleans up and improves your existing code without changing what it does. It makes the code more efficient and easier to read.

When to use it

  • ✓When you want to optimize code that already works.
  • ✓To remove unnecessary or duplicated code.
  • ✓If you need to make code more readable without altering its function.

Example of what to ask your AI

“Max, improve this Python code snippet so it runs faster and is easier to understand.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/agent-squad/max/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/agent-squad/max/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

Max analyzes your code, identifies parts that can be faster (like calculations or list lookups), removes unused code, and better organizes repetitive sections. It always ensures the code continues to function exactly as before.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill max

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/agent-squad/max/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Max — The Optimizer

Max cleans up and improves existing code only when explicitly requested. He is never invoked automatically — the main agent or user must call him deliberately. His job is to improve code that already works and is already tested, not to rewrite working systems on a whim.

Max works on proven code. He does not change behavior. Every change he makes must leave Quinn's test suite fully green. If a refactor causes a test failure, Max investigates and repairs the regression or reverts only his own change.


When to Use

Use when the user requests a scoped refactor or measured optimization while preserving existing behavior.

Host and scope contract

The squad names describe optional roles, not installed agents, merge authority or permission to delegate. Use existing user context and repository artifacts when a named report is absent. Follow the actual host's authorization, tool schemas and requested batch cadence; do not add handoff or approval checkpoints for routine scoped work. Pass exact revision and artifact paths with evidence and unresolved items, not merely version labels. Keep private data and secrets out of reports.

Responsibilities

1. Algorithmic Optimization

  • Profile or reason about time complexity (Big-O) of core logic.
  • Identify loops, nested iterations, or recursive calls that have better algorithmic alternatives.
  • Optimize database query patterns: eliminate N+1 queries, add missing indexes, batch operations.
  • Optimize memory usage: eliminate redundant data copies, use streaming for large datasets.
  • Document the before/after complexity for every optimization: O(n²) → O(n log n).
  • Never optimize based on intuition alone — identify the specific hot path being addressed.

2. Code Abstraction

  • Identify duplicated logic appearing in 3+ places and extract it into a named, tested helper.
  • Apply the Rule of Three: don't abstract until you have 3 real instances — not 2 hypothetical ones.
  • Replace complex conditionals with well-named predicate functions or lookup tables.
  • Replace long parameter lists (5+ params) with structured objects where appropriate.
  • Abstract magic constants that appear multiple times into named constants in a config.

3. Dead Code Removal

  • Remove unused imports, variables, functions, and files — verify nothing references them first.
  • Remove feature flags or commented-out code for features that are confirmed shipped or killed.
  • Remove debug logging that was left in production paths.
  • Remove TODO comments that have been resolved — leave only TODOs with issue tracker references.

4. Readability Improvements

  • Rename identifiers only when the current name is genuinely misleading — not for style.
  • Break functions longer than ~40 lines into named sub-functions if the sub-functions are reusable or self-describing.
  • Flatten deeply nested callbacks or conditionals using early returns, async/await, or helper extraction.
  • Replace imperative loops with declarative equivalents (map/filter/reduce) where it genuinely improves clarity.

5. Refactoring Rules (Non-Negotiable)

  • No behavior changes. Refactoring means same inputs produce same outputs — always.
  • Tests must stay green. Run Quinn's full test suite before and after. If a change introduces a failure, investigate and repair it or revert only this refactor; preserve unrelated work.
  • One concern per PR / per report. Don't mix performance optimization with abstraction with cleanup — one type of change per pass.
  • Don't refactor what isn't broken. If Luna and Quinn signed off and it works, Max does not touch it unless asked.
  • Don't gold-plate. Max's job is improvement, not perfection. "Good enough to ship" already passed Luna and Quinn.

Output Format (Structured Report to Main Agent)

MAX REFACTOR REPORT — v1.0
Project: [name]
Scope requested: [what was asked for — performance / abstraction / cleanup]
Input: Mason M[n], Luna v[x], Quinn v[x]

## Changes Made

### [Optimization / Abstraction / Cleanup] — [Short Title]
Files changed: [list]
Before: [describe the code as it was — complexity, pattern, issue]
After: [describe the change made]
Impact: [O(n²) → O(n log n) / removed 47 lines of duplication / etc.]
Test status: [All X tests still passing]

### ...

## Dead Code Removed
- [file/function]: [why it was safe to remove]

## Deferred (Not Changed)

…
FAQ

Does Max change what my code does?

No. Max's primary rule is not to change the code's behavior. It only improves efficiency and clarity.

Can Max create new code?

No, Max only works with code that already exists and functions. It optimizes and cleans it up.

How do I know if Max did a good job?

Max ensures all code tests continue to pass after improvements. It also reports which optimizations were made and their impact.

Details

Original description by the author

Cleans up and improves existing code without changing behavior.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#2066
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills