profile-code
Measure execution time and memory usage of code. Use when analyzing performance characteristics.
When & Why to Use This Skill
The profile-code skill is a specialized performance analysis utility designed to measure execution time and memory consumption. It empowers developers to identify critical bottlenecks, analyze CPU vs. memory tradeoffs, and optimize hot code paths through detailed instrumentation and reporting, ensuring software runs at peak efficiency.
Use Cases
- Performance Bottleneck Identification: Pinpoint specific functions or code segments that consume excessive CPU time using tools like cProfile to prioritize optimization efforts.
- Memory Leak & Usage Detection: Monitor real-time memory allocation per function to identify leaks or high-memory-footprint data structures in resource-constrained environments.
- Algorithm Benchmarking: Quantitatively compare the execution speed and resource efficiency of different algorithmic implementations to make data-driven architectural choices.
- Optimization Validation: Generate comprehensive profiling reports before and after code changes to verify that performance improvements are effective and haven't introduced regressions.
- Call Graph Analysis: Visualize function call hierarchies and execution flow to understand complex code interactions and reduce redundant processing overhead.
| name | profile-code |
|---|---|
| description | "Measure execution time and memory usage of code. Use when analyzing performance characteristics." |
| mcp_fallback | none |
| category | analysis |
| tier | 2 |
| user-invocable | false |
Profile Code
Use profiling tools to measure CPU time, memory allocation, and identify performance bottlenecks in code.
When to Use
- Finding performance bottlenecks
- Measuring CPU vs memory tradeoffs
- Understanding where code spends most time
- Optimizing hot code paths
Quick Reference
# Python CPU profiling with cProfile
python3 -m cProfile -s cumulative script.py | head -30
# Memory profiling
pip install memory-profiler
python3 -m memory_profiler script.py
# Detailed call graph
pip install graphviz
python3 -m pstats /tmp/profile.prof
Workflow
- Select profiler: Choose appropriate tool (cProfile for CPU, memory_profiler for memory)
- Run with instrumentation: Execute code with profiling enabled
- Capture metrics: Record timing and memory data
- Analyze output: Identify top time consumers and memory hogs
- Report findings: Document bottlenecks with before/after context
Output Format
Profiling report:
- Top functions by execution time
- Call count for each function
- Memory allocation per function
- Call graph/call tree
- Percentage of total time/memory per function
- Recommendations for optimization
References
- See
suggest-optimizationsskill for improvement recommendations - See
benchmark-functionsskill for measuring improvements - See CLAUDE.md > Performance for optimization guidelines