lighthouse-fixer

What This Skill Does

The lighthouse-fixer skill is a powerful developer utility designed to bridge the gap between abstract Lighthouse audit reports and actionable code fixes. While standard Lighthouse reports provide performance metrics and general documentation links, they often lack the context required to resolve complex technical debt. This agent-powered tool executes a full Lighthouse audit against any specified URL, ingests the comprehensive report data, and leverages GPT-4o-mini to synthesize specific, code-level recommendations. It translates complex performance bottlenecks—such as render-blocking resources, excessive DOM sizes, or suboptimal image loading—into concrete tasks that developers can implement immediately. By prioritizing issues based on their potential impact on Core Web Vitals and user experience, it acts as an intelligent performance consultant embedded directly within your development workflow.

Installation

To integrate this skill into your OpenClaw environment, use the following command in your terminal:

clawhub install openclaw/skills/skills/lxgicstudios/lighthouse-fixer

Ensure you have Node.js 18 or higher installed on your system. Additionally, you must provide an OPENAI_API_KEY in your environment variables to allow the agent to process the audit analysis and generate tailored improvement suggestions. No local global installation of Lighthouse is required, as the skill handles dependencies via npx.

Use Cases

• Site Performance Optimization: Regularly audit production or staging sites to identify regressions in load times.
• Core Web Vitals Remediation: Diagnose failing LCP (Largest Contentful Paint) or CLS (Cumulative Layout Shift) scores.
• SEO Technical Audits: Improve search rankings by resolving performance-related accessibility and efficiency issues flagged by Google.
• Legacy Code Refactoring: Use the tool on aging codebases to pinpoint specific scripts or DOM structures that are hindering browser performance.

Example Prompts

• "Run a lighthouse-fixer audit on https://my-portfolio-site.com and tell me which images are preventing a 90+ performance score."
• "Analyze the performance issues for my admin dashboard at https://staging.example.com and provide a prioritized list of code changes to reduce the TBT."
• "Perform a mobile-focused audit on https://blog.mysite.com and explain why the layout is shifting during load."

Tips & Limitations

To maximize the effectiveness of the lighthouse-fixer, follow these best practices: Always prioritize performance fixes that impact the above-the-fold content, as these yield the highest perceived speed gains. Since network conditions vary, test your site on simulated slow connections to catch issues that don't appear on local high-speed fiber. Be mindful that the tool requires an active internet connection to crawl the target URL and reach OpenAI's API. Avoid running audits on password-protected pages without configuring proper headers or authentication context first, as the tool may only be able to audit the login redirect page.