Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add rules/adobecom/express-milo/lighthouse-performance-troubleshootinggit clone --depth 1 https://github.com/adobecom/express-miloWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.02166 | $0.02166 |
| Opus 5 | $0.01083 | $0.01083 |
| Sonnet 5 | $0.00433 | $0.00433 |
| Haiku 4.5 | $0.00217 | $0.00217 |
Grade A, and why
lighthouse-performance-troubleshooting scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
100% identical to lighthouse-performance-troubleshooting — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 304 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Lighthouse Performance Troubleshooting Guide
APPLY: EVERY QUERY - LIGHTHOUSE SCORE OPTIMIZATION
Target Performance Scores
Based on Express-Milo architecture requirements:
- Performance: 90+ (Target: 97-100)
- Accessibility: 100
- Best Practices: 100
- SEO: 92+
Critical Performance Issues & Solutions
Issue 1: LCP > 3 seconds (Score drops from 100 to 86)
Root Cause Analysis:
- Large content elements not optimized for LCP detection
- Render-blocking resources in critical path
- Poor content hierarchy in first section
REQUIRED Solutions:
/* ✅ First section must dominate viewport */
.section:first-child {
min-height: 100vh;
background-image: url('high-entropy-image.jpg');
background-size: cover;
}
/* ✅ Ensure LCP element is largest contentful element */
.section:first-child h1 {
font-size: clamp(2rem, 5vw, 4rem);
margin: 2rem 0;
}
/* ✅ Make first section image larger than second section */
.section:first-child img {
width: 100%;
max-width: 800px; /* Larger than second section */
}
.section:nth-child(2) img {
max-width: 600px; /* Smaller than first section */
}
Content Strategy Fix:
// ✅ Auto-block to ensure proper LCP structure
function buildAutoBlocks(main) {
const firstSection = main.querySelector('.section');
const h1 = firstSection?.querySelector('h1');
const firstImage = firstSection?.querySelector('img');
if (firstSection && (!firstImage || hasLowEntropy(firstImage))) {
// Add high-entropy background for LCP detection
firstSection.style.backgroundImage = 'url("/express/assets/hero-texture.jpg")';
firstSection.classList.add('hero-section');
}
}
Issue 2: Largest Contentful Paint Optimization
Problem: LCP element not in first section (common cause of 86 vs 100 score)
Diagnostic Steps:
- Check LCP element location: Use Chrome DevTools → Performance → Web Vitals
- Verify first section dominance: Ensure first section fills viewport
- Image size hierarchy: First section image > second section image
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 304 lines · 2,166 tokens per session scan A e0aa4c1279bd
lighthouse-performance-troubleshooting is a cursor rule published in the GitHub repository adobecom/express-milo (6 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 2,166 tokens to every session, about $0.0108 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to lighthouse-performance-troubleshooting, differing in 0 lines, and is treated as a copy.
Other cursor rules, from other repositories
angular-20
This rule provides comprehensive best practices and coding standards for Angular development, focusing on modern TypeScript, standalone components, signals, and performance optimizations.
dev-standard
Apache Superset development standards and guidelines for Cursor IDE.
cli-error-handling
CLI command error handling patterns.
prefer-direct-imports-over-module-mocks
Prefer extracting a testable core over vi.mock / vi.resetModules when unit tests need to reach production logic entangled with config, env, or singletons.
control-plane-descriptors
Control plane descriptor and instance implementation patterns.
family-instance-domain-actions
Family instance domain action implementation patterns.