Agent skill

Perf

by alamenai in alamenai/terrae

Audit component performance and identify optimization opportunities with actionable fixes

MITAuto-check passedDevelopment

Install Perf

skills CLI
$ npx skills add alamenai/terrae --skill perf -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alamenai/terrae perf --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alamenai/terrae.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/perf .claude/skills/perf && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
perf
GitHub stars
244
Token cost
~678 tokens
SKILL.md length
271 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Audit component performance and identify optimization opportunities with actionable fixes

  • Works in 3 steps: Identify Target → Run the Audit → Report
  • Development work in your project
  • SKILL.md covers Instructions and Scoring Guide
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Perf is an agent skill from alamenai/terrae. Audit component performance and identify optimization opportunities with actionable fixes

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Mapbox and React. The repository describes itself as: Composable and animated components that replace imperative layers with simple props. The perfect companion for shadcn/ui. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/perf”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash(git diff*)

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Identify Target
  2. Run the Audit
  3. Report

What it can do on your machine

Read from SKILL.md and the folder at commit ea9a480. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Bash(git diff*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Perf loads about 678 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 271 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~678

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alamenai/terrae at commit ea9a480, republished under its MIT licence (© alamenai). 271 words, ~678 tokens.

Download SKILL.mdSave it as .claude/skills/perf/SKILL.md (or your agent's skills folder).
name
perf
description
Audit component performance and identify optimization opportunities with actionable fixes
allowed-tools
Read, Grep, Glob, Bash(git diff*)
argument-hint
component-name

Performance Audit Skill

Audit Terrae components for performance issues. Identifies problems, explains their impact, and provides actionable fixes.

If $ARGUMENTS is provided, audit only that component. Otherwise, audit all components in src/registry/map/.

Performance patterns and best practices are defined in .claude/rules/react/performance.md.

Instructions

Step 1: Identify Target

If a component name is provided, locate it in src/registry/map/. Otherwise, scan all component files.

Step 2: Run the Audit

For each component, read the full file and check every rule in .claude/rules/react/performance.md:

  1. Resource cleanup (RAF, timers, listeners, markers, layers, sources, images, observers, canvas)
  2. Recursive requestAnimationFrame polling
  3. Untracked timers in renderers
  4. Mapbox objects in state vs refs
  5. useEffect dependency arrays (oversized, unstable references, callbacks)
  6. Layer and source management (setPaintProperty vs remove/re-add, existence checks)
  7. GeoJSON data handling (recomputation, update frequency)
  8. Canvas performance (pixel ratio, size, getImageData, off-screen canvas)
  9. DOM manipulation (innerHTML, style injection)
  10. Memory leaks (event listeners, growing collections, stale closures)

Also check for:

  • Component re-render cost (expensive computations in render path, large JSX trees)
  • Duplicate utility functions across files (DRY violations that bloat bundle size)
Step 3: Report

Structure the report as:

## Performance Audit: [Component Name]

### Score: [X/10]

### Critical Issues
Issues that cause measurable performance degradation or memory leaks.

### Warnings
Patterns that could degrade performance under load or over time.

### Best Practices
Recommendations for following optimal patterns.

### Passed Checks
Checks that the component already handles correctly.

For each issue found, include:

  • What: Description of the problem
  • Where: File path and line number
  • Impact: What happens if not fixed (memory leak, jank, unnecessary re-renders, etc.)
  • Fix: Concrete code example showing the solution

Scoring Guide

  • 10/10: No issues found, follows all best practices
  • 8-9/10: Minor warnings only, no performance impact
  • 6-7/10: Some warnings that could cause issues under load
  • 4-5/10: Has performance issues that affect user experience
  • 2-3/10: Critical issues causing memory leaks or severe jank
  • 0-1/10: Fundamentally broken performance patterns

© alamenai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/perf of alamenai/terrae.

Open the folder on GitHubat commit ea9a480

Compare with similar skills

Perf next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Perf compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perf this skillalamenai/terrae244—~678Automated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Electron Multi-Process ArchitectureiOfficeAI/AionUi33k1 repos~1.8kAutomated safety check: PassApache-2.0
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence
@pierre/diffs Code Renderingpierrecomputer/pierre6.3k2 repos~803Automated safety check: PassApache-2.0
OpenTUI Terminal Interfacescline/cline70k—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • Tells the agent where new code belongs in an Electron multi-process project and which APIs each process may use, with rules for new bridges, services, agents and workers.

    33k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed
  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed
  • @pierre/diffs Code Rendering

    pierrecomputer/pierre

    Guides an agent through using @pierre/diffs to render syntax-highlighted files and diffs, and to build editing and review surfaces in React or plain JavaScript.

    6.3k GitHub starsUsed in 2 repos~803 tokens
    DevelopmentAuto-check passed
  • Helps build terminal user interfaces with OpenTUI using its core imperative API or its React and Solid reconcilers, with references for layout, keyboard, animation and testing.

    70k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Claude Code Skill

    codeaashu/claude-code

    Development conventions and architecture guide for the Claude Code CLI repository.

    3.4k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed

More from alamenai/terrae

All 11 skills in this repo
  • Check

    alamenai/terrae

    Verify all outputs exist after creating a new component and fix any issues

    244 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Docs

    alamenai/terrae

    Generate or update documentation for Terrae components. An agent skill from alamenai/terrae.

    244 GitHub stars~576 tokensUpdated 6 mo ago
    Auto-check passed
  • Fix

    alamenai/terrae

    Systematically fix issues found by /review or reported by the user

    244 GitHub stars~775 tokensUpdated 6 mo ago
    Auto-check passed
  • New

    alamenai/terrae

    End-to-end workflow for building a new Terrae component from scratch

    244 GitHub stars~2.4k tokensUpdated 6 mo ago
    Auto-check passed
  • PR

    alamenai/terrae

    Commit, push, and open a pull request on GitHub. An agent skill from alamenai/terrae.

    244 GitHub stars~767 tokensUpdated 6 mo ago
    Auto-check: notes
  • Commit

    alamenai/terrae

    Create standardized git commits following Terrae's conventions

    244 GitHub stars~568 tokensUpdated 6 mo ago
    Auto-check: notes

Works with

Categories

Questions about Perf

What does Perf do?

Audit component performance and identify optimization opportunities with actionable fixes. Perf is an agent skill from alamenai/terrae.

When should I use Perf?

Perf fits situations like: development work in your project.

How do I install Perf in Claude Code?

Run `npx skills add alamenai/terrae --skill perf -a claude-code`. Or copy the skill folder (.claude/skills/perf in alamenai/terrae) into .claude/skills/perf in your project. Claude Code loads it when a task matches its description.

How do I install Perf in Codex?

Run `npx skills add alamenai/terrae --skill perf -a codex`. Or copy the skill folder (.claude/skills/perf in alamenai/terrae) into .agents/skills/perf in your project. Codex loads it when a task matches its description.

Can I use Perf in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alamenai/terrae --skill perf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/perf, .gemini/skills/perf, .github/skills/perf and .opencode/skills/perf in your project.

What does Perf need to run?

SKILL.md names no scripts, command-line tools or credentials: Perf is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash(git diff*).

Does Perf access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Perf safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Perf use?

Perf is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Perf use?

About 678 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Perf?

Skills that share tags, products or a category with Perf: Vercel Composition Patterns (supabase/supabase, 111k stars), Electron Multi-Process Architecture (iOfficeAI/AionUi, 33k stars), Nx Generate (nomcopter/react-mosaic, 4.8k stars) and @pierre/diffs Code Rendering (pierrecomputer/pierre, 6.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perf?

alamenai (a GitHub user) maintains it in alamenai/terrae, which has 244 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on April 6, 2026.

Source: alamenai/terrae on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.