CtrlK
BlogDocsLog inGet started
Tessl Logo

perf-lighthouse

Run Lighthouse audits locally via CLI or Node API, parse and interpret reports, and set performance budgets. Use when measuring site performance, understanding Lighthouse scores, setting up budgets, or integrating audits into CI. Triggers on: lighthouse, run lighthouse, lighthouse score, performance audit, performance budget. Do NOT use for fixing specific performance issues (use perf-web-optimization or core-web-vitals) or Astro-specific optimization (use perf-astro).

92

Quality

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

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 capabilities, natural trigger terms, clear 'what' and 'when' guidance, and explicit negative boundaries to prevent conflicts with related skills. The inclusion of 'Do NOT use for' clauses with references to alternative skills is a best practice that further strengthens distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Run Lighthouse audits locally via CLI or Node API, parse and interpret reports, and set performance budgets.' These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (run audits, parse reports, set budgets) and 'when' (measuring site performance, understanding scores, setting up budgets, integrating into CI). Also includes explicit 'Use when' and 'Triggers on' clauses, plus negative boundaries for when NOT to use it.

3 / 3

Trigger Term Quality

Explicitly lists natural trigger terms users would say: 'lighthouse, run lighthouse, lighthouse score, performance audit, performance budget.' These cover common variations of how users would phrase requests.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit boundary-setting via 'Do NOT use for' clauses that differentiate it from perf-web-optimization, core-web-vitals, and perf-astro skills. The Lighthouse-specific focus creates a clear niche.

3 / 3

Total

12

/

12

Passed

Implementation

79%

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, highly actionable skill with excellent concrete examples covering CLI usage, Node API, CI integration, budgets, and report parsing. Its main weaknesses are the length (could benefit from splitting advanced topics into referenced files) and the lack of explicit validation checkpoints or feedback loops connecting the various workflows together. The content respects Claude's intelligence throughout with zero unnecessary explanation.

Suggestions

Add explicit validation/feedback steps, e.g., after running with a budget, explain how to interpret failures and iterate (validate -> fix -> re-audit loop).

Split advanced sections (GitHub Actions, LHCI, Compare Builds) into separate referenced files to keep SKILL.md as a concise overview with links to detailed guides.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. No unnecessary explanations of what Lighthouse is or how it works—it jumps straight into actionable commands and code. Every section earns its place with concrete examples.

3 / 3

Actionability

Every section provides fully executable, copy-paste ready code: CLI commands with real flags, complete Node API scripts, full GitHub Actions YAML, complete budget.json, and working comparison scripts. Nothing is pseudocode or vague.

3 / 3

Workflow Clarity

Individual sections are clear, but the overall workflow lacks explicit sequencing and validation checkpoints. For example, there's no guidance on verifying budget.json is valid before running, no feedback loop for when audits fail assertions, and the Compare Builds section assumes a compare-reports.js exists without connecting it to the provided script.

2 / 3

Progressive Disclosure

The content is well-organized with clear section headers and progresses from simple CLI to advanced CI integration. However, at ~180 lines it's quite long for a SKILL.md and could benefit from splitting the CI integration, Node API, and report parsing into separate referenced files rather than inlining everything.

2 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
Reviewed

Table of Contents

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.