AGENT SKILL

perf-profile

Structured performance profiling workflow. Identifies bottlenecks, measures against budgets, and generates optimization recommendations with priority rankings.

License 许可
MIT
最近更新
2026-11-12
Stars
★ 3
Forks
1

01 前言 Front Matter

name
perf-profile
description
Structured performance profiling workflow. Identifies bottlenecks, measures against budgets, and generates optimization recommendations with priority rankings.
allowed-tools
Read, Glob, Grep, Bash
argument-hint
[system-name or 'full']
user-invocable
true

03 SKILL.md 正文

When this skill is invoked:

  1. Determine scope from the argument:

    • If a system name: focus profiling on that specific system
    • If full: run a comprehensive profile across all systems
  2. Read performance budgets — Check for existing performance targets in design docs or CLAUDE.md:

    • Target FPS (e.g., 60fps = 16.67ms frame budget)
    • Memory budget (total and per-system)
    • Load time targets
    • Draw call budgets
    • Network bandwidth limits (if multiplayer)
  3. Analyze the codebase for common performance issues:

    CPU Profiling Targets:

    • _process() / Update() / Tick() functions — list all and estimate cost
    • Nested loops over large collections
    • String operations in hot paths
    • Allocation patterns in per-frame code
    • Unoptimized search/sort over game entities
    • Expensive physics queries (raycasts, overlaps) every frame

    Memory Profiling Targets:

    • Large data structures and their growth patterns
    • Texture/asset memory footprint estimates
    • Object pool vs instantiate/destroy patterns
    • Leaked references (objects that should be freed but aren't)
    • Cache sizes and eviction policies

    Rendering Targets (if applicable):

    • Draw call estimates
    • Overdraw from overlapping transparent objects
    • Shader complexity
    • Unoptimized particle systems
    • Missing LODs or occlusion culling

    I/O Targets:

    • Save/load performance
    • Asset loading patterns (sync vs async)
    • Network message frequency and size
  4. Generate the profiling report:

    ## Performance Profile: [System or Full]
    Generated: [Date]
    
    ### Performance Budgets
    | Metric | Budget | Estimated Current | Status |
    |--------|--------|-------------------|--------|
    | Frame time | [16.67ms] | [estimate] | [OK/WARNING/OVER] |
    | Memory | [target] | [estimate] | [OK/WARNING/OVER] |
    | Load time | [target] | [estimate] | [OK/WARNING/OVER] |
    | Draw calls | [target] | [estimate] | [OK/WARNING/OVER] |
    
    ### Hotspots Identified
    | # | Location | Issue | Estimated Impact | Fix Effort |
    |---|----------|-------|------------------|------------|
    | 1 | [file:line] | [description] | [High/Med/Low] | [S/M/L] |
    | 2 | [file:line] | [description] | [High/Med/Low] | [S/M/L] |
    
    ### Optimization Recommendations (Priority Order)
    1. **[Title]** — [Description of the optimization]
       - Location: [file:line]
       - Expected gain: [estimate]
       - Risk: [Low/Med/High]
       - Approach: [How to implement]
    
    ### Quick Wins (< 1 hour each)
    - [Simple optimization 1]
    - [Simple optimization 2]
    
    ### Requires Investigation
    - [Area that needs actual runtime profiling to determine impact]
    
  5. Output the report with a summary: top 3 hotspots, estimated headroom vs budget, and recommended next action.

Rules

  • Never optimize without measuring first — gut feelings about performance are unreliable
  • Recommendations must include estimated impact — "make it faster" is not actionable
  • Profile on target hardware, not just development machines
  • Distinguish between CPU-bound, GPU-bound, and I/O-bound bottlenecks
  • Consider worst-case scenarios (maximum entities, lowest spec hardware, worst network conditions)
  • Static analysis (this skill) identifies candidates; runtime profiling confirms

04 同仓库更多 Skills

welflau
welflau/ai-dev-system

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

测试与质量前端开发
★ 3
welflau
welflau/ai-dev-system

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

邮件与沟通
★ 3
welflau
welflau/ai-dev-system

web-artifacts-builder

Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

前端开发
★ 3
welflau
welflau/ai-dev-system

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

设计师前端开发视觉设计
★ 3
welflau
welflau/ai-dev-system

algorithmic-art

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

视觉设计
★ 3
welflau
welflau/ai-dev-system

theme-factory

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

视觉设计
★ 3