Skip to content
SkillModel-led3,786 tokens in use

performance-optimization

Measure first, fix the proven bottleneck, re-measure and keep only changes that beat the baseline.

119,377 stars on the repository MIT Licenseaddyosmani/agent-skills · skills/performance-optimization
npx skills add addyosmani/agent-skills --skill performance-optimization
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing performance-optimization costs

61tokens idle
3,786tokens in use
6,177tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 206

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community76
  • Maturity32
  • Momentum40

Performance Optimization guides an agent through frontend, backend and database performance work with a five-step loop: measure, identify, fix, verify and guard. It sets Core Web Vitals targets and gives a symptom tree for deciding what to measure first.

The skill covers N+1 queries, pagination, query plans and indexes, connection pools, caching design, image optimization, re-renders and bundle size. A change that stays within noise is reverted, and every attempt is logged in a ledger.

What You Get

  • A measure, identify, fix, verify and guard workflow
  • Core Web Vitals thresholds and example performance budgets
  • Anti-pattern entries with worked fixes in a references file
  • A red flag list and a verification checklist

Common Use Cases

  • Fixing slow API responses
  • Improving Core Web Vitals
  • Reviewing a suspected performance regression
  • Setting performance budgets in CI

What Makes It Unique

The skill treats a neutral result as a revert, requires the same measurement method for baseline and result and asks for a ledger of tried ideas so dead ends are not repeated. Its backend entries cover pool exhaustion and cache key design, which general advice often skips.

Under The Hood

The skill loads a SKILL.md and, when needed, a references file of worked patterns. The agent runs profiling and measurement tools such as Lighthouse, the web-vitals library, query EXPLAIN and bundle size checks, and may add CI steps with npx. It ships no scripts.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers