performance-skills

Agent-loadable skill files distilled from each article on performance.dev. Drop them into Claude Code, Codex, or Cursor and your agent picks up the techniques — perceived-performance playbooks, local-first sync, architecture decisions — when the task calls for them.

The browsable catalogue with install commands for every surface lives at performance.dev/skills.

Install

Option A: Claude Code Plugin (recommended)

From within Claude Code, first add the marketplace:

/plugin marketplace add brotzky/performance-skills

Then install the plugin:

/plugin install performance@skills

This installs every skill at once, making them available across all your projects. Claude Code auto-loads each one when the task description matches.

Option B: CLAUDE.md (per-project)

New project:

curl -o CLAUDE.md https://raw.githubusercontent.com/brotzky/performance-skills/main/CLAUDE.md

Existing project (append):

echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/brotzky/performance-skills/main/CLAUDE.md >> CLAUDE.md

Option C: One skill at a time

Each skill is also served from performance.dev at the same path as the source article + .md. e.g.:

mkdir -p ~/.claude/skills/linear-local-first-architecture
curl -fsSL https://performance.dev/how-is-linear-so-fast-a-technical-breakdown.md \
  > ~/.claude/skills/linear-local-first-architecture/SKILL.md

The full list of available .md URLs is at performance.dev/llms.txt.

Using with Cursor

This repository includes a committed Cursor project rule (.cursor/rules/perf-guidelines.mdc) so the same guidelines apply when you open the project in Cursor. See CURSOR.md for setup, using the rule in other projects, and how this relates to Claude Code.

Using with Codex

Codex auto-loads AGENTS.md from the project root on every session. Append a single skill:

curl -fsSL https://performance.dev/how-is-linear-so-fast-a-technical-breakdown.md >> AGENTS.md

Or the full bundle:

curl -fsSL https://raw.githubusercontent.com/brotzky/performance-skills/main/CLAUDE.md >> AGENTS.md

Canonical source

This repo is auto-synced from the canonical content store on performance.dev. Don't open PRs against the skill files here — edit the source article in the performance.dev admin and regenerate the skill; the updated SKILL.md, CLAUDE.md, and Cursor rule land here automatically on the next change.

What's in each file

Path	Auto-synced	Purpose
performance/skills/<name>/SKILL.md	yes	Per-skill agent file in Claude Agent SDK format
CLAUDE.md	yes	Concatenated skills, formatted as project-level Claude Code instructions
.cursor/rules/perf-guidelines.mdc	yes	Same content, formatted as a Cursor project rule
.claude-plugin/marketplace.json	no	Plugin marketplace manifest (name: skills)
performance/.claude-plugin/plugin.json	no	Plugin manifest for the performance plugin
CURSOR.md	no	Docs for the Cursor setup
README.md	no	You are here