Pagespeed Insights
Audit landing pages and apps against PageSpeed Insights and Core Web Vitals guidance before release or SEO pushes.
Overview
PageSpeed Insights is an agent skill most often used in Ship (also Launch SEO) that guides Core Web Vitals and PSI v5 audits for solo web launches.
Install
npx skills add https://github.com/enderpuentes/ai-agent-skills --skill pagespeed-insightsWhat is this skill?
- Documents official PageSpeed Insights v5 API and measurement concepts for agent-driven audits.
- Aligns recommendations with Google Core Web Vitals expectations for real-user performance.
- Free-use skill packaging with clear separation from CC BY 4.0 Google documentation licensing.
- Educational workflow for interpreting PSI scores and remediation priorities.
- Suited for solo builders shipping marketing sites, SaaS dashboards, or storefront frontends.
Adoption & trust: 597 installs on skills.sh; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your site feels slow or ranks poorly and you need a structured way to interpret PageSpeed Insights metrics and fix priorities with your agent.
Who is it for?
Solo builders shipping Next.js, marketing sites, or ecommerce fronts who want vitals-aware review without memorizing Google docs.
Skip if: Native mobile app performance (non-WebView) or backend-only APIs with no user-facing HTML.
When should I use this skill?
You are shipping or polishing a public URL and need structured PageSpeed Insights and Core Web Vitals interpretation.
What do I get? / Deliverables
You get agent-guided PSI and Core Web Vitals interpretation with remediation focus areas before merge or go-live.
- Prioritized performance findings mapped to Core Web Vitals
- Remediation checklist aligned with PageSpeed Insights documentation
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Performance gates belong on the Ship shelf first; the same PSI literacy supports Launch visibility work. Perf subphase covers lab and field metrics (LCP, INP, CLS) that block confident shipping for web products.
Where it fits
Run a pre-release PSI review on staging URLs and prioritize LCP image and font fixes.
Align vitals fixes with search-facing landing pages before indexing push.
Re-audit blog or docs templates after adding third-party embeds.
How it compares
Documentation-driven audit skill—not a hosted PSI MCP server or automatic CI gate by itself.
Common Questions / FAQ
Who is pagespeed-insights for?
Solo and indie web builders using Claude Code, Cursor, or similar agents who need PageSpeed and Core Web Vitals literacy during ship and launch.
When should I use pagespeed-insights?
In Ship perf reviews before release; in Launch SEO passes when vitals affect rankings; in Grow content updates when landing pages change.
Is pagespeed-insights safe to install?
Review the Security Audits panel on this Prism page; invoking PSI may require API keys and network access you control separately.
SKILL.md
READMESKILL.md - Pagespeed Insights
# License ## Skill License - Free Use This skill (the documentation, structure, and implementation) was created by **Ender Puentes <Endev/>** and is provided for **free and open use**. You are free to: - ✅ **Use** this skill in any project, personal or commercial - ✅ **Modify** the skill to fit your needs - ✅ **Distribute** the skill to others - ✅ **Share** modified versions of the skill - ✅ **Include** this skill in your own skill collections **No restrictions apply** - this skill is available for unrestricted use. Attribution is appreciated but not required. **Note**: This skill documents and references the PageSpeed Insights guidelines and Core Web Vitals specifications, but the skill itself is an independent work created for team use. --- ## PageSpeed Insights Documentation This skill documents the [PageSpeed Insights documentation](https://developers.google.com/speed/docs/insights/v5/about?hl=es-419), which is a separate work created by Google. **The PageSpeed Insights documentation is NOT owned by the skill author.** The documentation has its own license: **Creative Commons Attribution 4.0 International (CC BY 4.0)** For information about the PageSpeed Insights documentation license, visit: https://creativecommons.org/licenses/by/4.0/ **Documentation Source**: https://developers.google.com/speed/docs/insights/v5/about?hl=es-419 This skill simply documents and references the official PageSpeed Insights guidelines for educational and practical use. The skill author claims no ownership or rights over the PageSpeed Insights documentation itself. ## Skill Author This skill was created by **Ender Puentes <Endev/>** - https://enderpuentes.com The skill itself (as a documentation/implementation work) is released for free and unrestricted use. While attribution is appreciated, it is not required for using, modifying, or distributing this skill. # PageSpeed Insights — Reference & Official Documentation This file complements the pagespeed-insights skill with official documentation links for indexing. ## Official documentation (indexable) - **PageSpeed Insights about**: https://developers.google.com/speed/docs/insights/v5/about?hl=es-419 - **PageSpeed Insights (tool)**: https://pagespeed.web.dev/ - **Lighthouse**: https://developer.chrome.com/docs/lighthouse/ - **Core Web Vitals**: https://web.dev/vitals/ - **Chrome User Experience Report (CrUX)**: https://developer.chrome.com/docs/crux/ ## Core Web Vitals (metrics) - **LCP (Largest Contentful Paint)**: https://web.dev/lcp/ - **FCP (First Contentful Paint)**: https://web.dev/fcp/ - **CLS (Cumulative Layout Shift)**: https://web.dev/cls/ - **INP (Interaction to Next Paint)**: https://web.dev/inp/ - **TTFB (Time to First Byte)**: https://web.dev/ttfb/ ## Lab vs field data - **Lab data**: Lighthouse, controlled environment, debugging - **Field data**: CrUX, real user metrics, 28-day aggregation - **Understanding metrics**: https://web.dev/metrics/ ## Performance optimization guides - **Optimize LCP**: https://web.dev/optimize-lcp/ - **Optimize CLS**: https://web.dev/optimize-cls/ - **Optimize INP**: https://web.dev/optimize-inp/ - **Optimize FCP**: https://web.dev/optimize-fcp/ - **Resource hints**: https://web.dev/preconnect-and-dns-prefetch/ - **Image optimization**: https://web.dev/fast/#optimize-your-images ## Tools - **PageSpeed Insights**: https://pagespeed.web.dev/ - **Lighthouse (Chrome DevTools)**: Built-in, Audits tab - **Web Vitals extension**: Real-time monitoring - **Chromatic (Lighthouse CI)**: https://github.com/GoogleChrome/lighthouse-ci ## Score thresholds (reminder) | Category | Good | Needs Improvement | Poor | |----------|------|-------------------|------| | Performance | 90-100 | 50-89 | 0-49 | | Accessibility | 90-100 | 50-89 | 0-49 | | Best Practices | 90-100 | 50-89 | 0-49 | | SEO | 90-100 | 50-89 | 0-49 | --- name: pagespeed-insights description: Audit web pages for performance optimization following PageSpeed Insights guideline