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

93%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

87%

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

This is a strong, well-structured skill that provides concrete, copy-paste-ready Astro performance optimization guidance. Its main weakness is the lack of explicit validation steps in the workflow—there's no feedback loop to verify that the optimizations actually improved scores before considering the task complete. The content is otherwise concise, actionable, and well-organized with appropriate cross-references.

Suggestions

Add a validation workflow after setup: e.g., '1. Run `npm run build` 2. Verify critters output shows inlining percentages 3. Run Lighthouse 4. If scores < 95, check the checklist items and rebuild.'

Dimension	Reasoning	Score
Conciseness	The content is lean and efficient. It doesn't explain what CSS inlining or compression are conceptually—it jumps straight to installation, configuration, and patterns. The brief descriptions of what astro-critters does are warranted since they describe non-obvious behavior specific to that integration. Every section earns its place.	3 / 3
Actionability	Fully executable code throughout: npm install commands, complete astro.config.mjs configuration, a full Layout.astro template with font loading, LCP preloading, and script deferral patterns. The Lighthouse command is copy-paste ready. The checklist provides a concrete verification list.	3 / 3
Workflow Clarity	The skill presents a clear setup sequence and a checklist, but lacks explicit validation checkpoints. After configuring integrations and the layout pattern, there's no step like 'build and verify critters output shows inlining' or 'run Lighthouse and check scores before/after.' For a performance optimization workflow, a build-then-validate feedback loop would strengthen this.	2 / 3
Progressive Disclosure	Content is well-structured with clear sections (Quick Setup → Integrations → Layout Pattern → Measuring → Checklist). References to related skills (perf-lighthouse, perf-web-optimization) are clearly signaled and one level deep. The skill appropriately keeps Astro-specific content inline while pointing elsewhere for general topics.	3 / 3
	Total	11 / 12 Passed

Description

100%

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

This is an excellent skill description that hits all the marks. It provides specific concrete actions, includes natural trigger terms, explicitly states both what and when, and proactively disambiguates from related skills with 'Do NOT use' guidance. The description is concise yet comprehensive, using proper third-person voice throughout.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: critical CSS inlining, compression, font loading, and LCP optimization. Also specifies a concrete target (95+ Lighthouse scores).	3 / 3
Completeness	Clearly answers both what (critical CSS inlining, compression, font loading, LCP optimization for Astro) and when (optimizing Astro site performance, improving Lighthouse scores, configuring astro-critters). Also includes explicit 'Do NOT use' guidance for disambiguation.	3 / 3
Trigger Term Quality	Excellent coverage of natural terms users would say: 'Astro', 'Lighthouse scores', 'performance', 'critical CSS', 'font loading', 'LCP', 'astro-critters', 'compression'. These are terms a developer would naturally use when seeking this help.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with clear niche (Astro-specific performance). Explicitly differentiates from related skills (perf-web-optimization, core-web-vitals, perf-lighthouse) with 'Do NOT use' clauses, minimizing conflict risk.	3 / 3
	Total	12 / 12 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: tech-leads-club/agent-skills
Commit: 5f9b25d

Reviewed: 5 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.