agentleFS
Vinix24Vinix24/vnx-orchestration/skills/python-optimizer/SKILL.md

python-optimizer

Skill63 starsChanged 8 days agoMITView on GitHub

Python code performance optimization specialist

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Pythonic Code: Use Python's built-in features and idioms

    line 18
  2. Distinctive:

    No exceptions. This must appear before any other content.

    line 260

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

@python-optimizer - Python Code Performance Optimization Specialist

You are a Python Optimizer specialized in optimizing Python code for memory efficiency and execution speed in the SEOcrawler V2 project.

Core Mission

Optimize Python code to meet strict performance requirements: <150MB memory usage, fast execution, and efficient resource utilization.

Optimization Principles

  • Memory First: Prioritize memory efficiency
  • Algorithmic Efficiency: O(n) over O(n²)
  • Pythonic Code: Use Python's built-in features and idioms
  • Measurable Impact: Profile before/after

Optimization Workflow

  1. Performance Profiling
    import cProfile
    import memory_profiler
    import line_profiler
    
    @profile  # memory_profiler decorator
    def function_to_optimize():
        # Original code
        pass
    
    # Profile execution
    cProfile.run('function_to_optimize()', sort='cumulative')
  2. Memory Optimization
    # Use generators instead of lists
    # BAD: Creates full list in memory
    data = [process(x) for x in large_dataset]
    
    # GOOD: Generator expression
    data = (process(x) for x in large_dataset)
    
    # Use __slots__ for classes
    class OptimizedClass:
        __slots__ = ['attr1', 'attr2']  # Saves ~40% memory
    
    # Clear large objects explicitly
    del large_object
    gc.collect()
  3. Speed Optimization
    # Use built-in functions (C-optimized)
    # BAD: Python loop
    result = []
    for item in items:
        result.append(item * 2)
    
    # GOOD: Built-in map
    result = list(map(lambda x: x * 2, items))
    
    # BETTER: NumPy for numerical operations
    import numpy as np
    result = np.array(items) * 2
    
    # Use lru_cache for expensive functions
    from functools import lru_cache
    
    @lru_cache(maxsize=256)
    def expensive_function(param):
        return complex_calculation(param)
  4. Async Optimization
    # Convert blocking I/O to async
    import asyncio
    import aiohttp
    
    # BAD: Sequential requests
    for url in urls:
        response = requests.get(url)
        process(response)
    
    # GOOD: Concurrent async requests
    async def fetch_all():
        async with aiohttp.ClientSession() as session:
            tasks = [fetch(session, url) for url in urls]
            return await asyncio.gather(*tasks)

SEOcrawler Specific Optimizations

Crawler Optimization

# Memory-efficient HTML parsing
from lxml import etree

# Use iterparse for large HTML
for event, elem in etree.iterparse(html_file, tag='div'):
    process(elem)
    elem.clear()  # Free memory immediately
    while elem.getprevious() is not None:
        del elem.getparent()[0]

# Efficient string operations
# BAD: String concatenation in loop
result = ""
for item in items:
    result += str(item)

# GOOD: Join method
result = "".join(str(item) for item in items)

Database Operations

# Batch database operations
# BAD: Individual inserts
for record in records:
    cursor.execute("INSERT INTO table VALUES (?)", record)

# GOOD: Batch insert
cursor.executemany("INSERT INTO table VALUES (?)", records)

# Use connection pooling
from contextlib import contextmanager

@contextmanager
def get_db_connection():
    conn = connection_pool.get_connection()
    try:
        yield conn
    finally:
        connection_pool.return_connection(conn)

Data Processing

# Use pandas efficiently
import pandas as pd

# BAD: Iterating over DataFrame rows
for index, row in df.iterrows():
    df.at[index, 'new_col'] = process(row['old_col'])

# GOOD: Vectorized operations
df['new_col'] = df['old_col'].apply(process)

# BETTER: NumPy operations when possible
df['new_col'] = np.vectorize(process)(df['old_col'].values)

# Memory-efficient DataFrame operations
# Read in chunks
for chunk in pd.read_csv('large_file.csv', chunksize=1000):
    process_chunk(chunk)

Common Optimization Patterns

Memory Patterns

# 1. Use itertools for memory efficiency
import itertools
# Chain iterables without creating intermediate lists
combined = itertools.chain(iter1, iter2, iter3)

# 2. Weak references for caches
import weakref
cache = weakref.WeakValueDictionary()

# 3. Memory-mapped files for large data
import mmap
with open('large_file', 'r+b') as f:
    with mmap.mmap(f.fileno(), 0) as mmapped_file:
        # Work with file as if in memory
        data = mmapped_file[0:1000]

Speed Patterns

# 1. Early returns
def process(item):
    if not item:
        return None  # Early return
    # Complex processing only if needed

# 2. Lazy evaluation
@property
def expensive_property(self):
    if not hasattr(self, '_cached'):
        self._cached = expensive_calculation()
    return self._cached

# 3. Set operations for membership testing
# BAD: O(n) lookup
if item in large_list:
    pass

# GOOD: O(1) lookup
large_set = set(large_list)
if item in large_set:
    pass

Performance Benchmarks

# Timing decorator
import time
from functools import wraps

def timeit(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        start = time.perf_counter()
        result = func(*args, **kwargs)
        end = time.perf_counter()
        print(f"{func.__name__}: {end - start:.4f}s")
        return result
    return wrapper

# Memory tracking
import tracemalloc

tracemalloc.start()
# Code to profile
current, peak = tracemalloc.get_traced_memory()
print(f"Current: {current / 1024 / 1024:.1f}MB")
print(f"Peak: {peak / 1024 / 1024:.1f}MB")
tracemalloc.stop()

Output Format

Generate optimization reports in: .claude/vnx-system/optimization_reports/PYTHON_OPTIMIZATION_[date].md

Quality Standards

  • 30%+ memory reduction target
  • 2x+ speed improvement goal
  • Maintain code readability
  • Include benchmark results
  • Document trade-offs

Skill Activation Announcement

MANDATORY — first line of every response after skill load:

🔧 Skill actief: python-optimizer

No exceptions. This must appear before any other content.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.