perf-astro

Astro-specific performance optimizations for 95+ Lighthouse scores. Covers critical CSS inlining, compression, font loading, and LCP optimization. Use when optimizing Astro site performance, improving Astro Lighthouse scores, or configuring astro-critters. Do NOT use for non-Astro sites (use perf-web-optimization or core-web-vitals) or running Lighthouse audits (use perf-lighthouse).

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

90%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, highly actionable playbook with copy-paste code and clear sections. Its main gap is the lack of explicit numbered workflow steps and a validation feedback loop, plus no progressive disclosure into reference files.

Suggestions

Add an explicitly numbered "Optimization workflow" sequence (install → configure → apply layout pattern → measure → iterate) so the process order is unambiguous.

Include a brief validate/retry feedback loop in the Measuring section (e.g., re-run Lighthouse, address the lowest metric, re-measure) to support iterative optimization.

Consider splitting the large Layout Pattern code block into a referenced reference file if the skill grows, to strengthen progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is lean and actionable — install command, config snippet, brief "What it does" bullets, and copy-paste layout code with no padding or explanation of concepts Claude already knows; every section earns its tokens.	5 / 5
Actionability	Provides fully executable, copy-paste-ready guidance: `npm install astro-critters @playform/compress`, a complete `astro.config.mjs`, compress options, a full `Layout.astro`, and a Lighthouse command covering the common optimization cases.	5 / 5
Workflow Clarity	A clear implicit sequence (install → configure integrations → layout → measure) with a checklist and a Measuring section as validation, but steps are not explicitly numbered and there is no validate-then-fix feedback loop, so it stops short of 5.	4 / 5
Progressive Disclosure	Well-organized into clear sections (Quick Setup, Integrations, Layout Pattern, Measuring, Checklist) with clearly signaled sibling-skill references, but it is a single self-contained file with no one-level-deep reference files, so it does not fully match the score-5 multi-file anchor.	4 / 5
	Total	18 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states capabilities, natural trigger phrases, and explicit boundaries against sibling skills. Minor room for more trigger synonyms, but overall highly distinctive and complete.

Dimension	Reasoning	Score
Specificity	"Covers critical CSS inlining, compression, font loading, and LCP optimization" lists multiple specific concrete optimization actions with comprehensive coverage, matching the score-5 anchor; it is not score 4 because no meaningful capability gaps remain.	5 / 5
Completeness	It explicitly states what ("Astro-specific performance optimizations... Covers critical CSS inlining, compression, font loading, and LCP optimization") and when ("Use when optimizing Astro site performance, improving Astro Lighthouse scores..."), with concrete trigger phrases including negative triggers.	5 / 5
Trigger Term Quality	"optimizing Astro site performance, improving Astro Lighthouse scores, or configuring astro-critters" gives good natural keyword coverage, but lacks synonyms or file extensions that would push it to 5.	4 / 5
Distinctiveness Conflict Risk	"Do NOT use for non-Astro sites (use perf-web-optimization or core-web-vitals) or running Lighthouse audits (use perf-lighthouse)" carves out a clear Astro niche with explicit boundary guidance, minimizing conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: tech-leads-club/agent-skills
Path: packages/skills-catalog/skills/(performance)/perf-astro/SKILL.md
Commit: fe318be

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.