What problem does it solve?
Manually configuring SHARK_LOOP_TIMEOUT and SHARK_MAX_LOOPS for Shark pattern AI coding agents relies on guesswork, leading to either frequent task timeouts from overly short settings or wasted idle time from overly long ones. This Skill eliminates that guesswork by analyzing actual historical timing data from your agent runs to deliver data-driven, tailored configuration recommendations.
Core Features & Use Cases
- Timing Data Analysis: Processes Shark agent timing logs to calculate key performance metrics including median and p95 turn times, timeout rates, loops to completion, and wasted headroom from overly generous timeouts.
- Evidence-Based Recommendations: Generates clear, justified suggestions for optimal SHARK_LOOP_TIMEOUT and SHARK_MAX_LOOPS values, with explicit rationale tied to your specific workload patterns.
- Use Case: If you run Shark agents for coding tasks and notice inconsistent timeout failures or excessive waiting between steps, use this Skill to replace generic default settings with values calibrated to your actual task execution times.
Quick Start
Use the shark-autotune skill to analyze your Shark agent's timing history and get recommended timeout and loop configuration settings.