结构化的性能分析工作流。识别瓶颈、与性能预算对比测量,并生成带有优先级排序的优化建议. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

MITAuto-check: notes

Install Perf Profile

skills CLI
$ npx skills add pixel-cellar/Claude-Code-Game-Studios --skill perf-profile -a claude-code

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

GitHub CLI
$ gh skill install pixel-cellar/Claude-Code-Game-Studios perf-profile --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/pixel-cellar/Claude-Code-Game-Studios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/perf-profile .claude/skills/perf-profile && 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-profile
GitHub stars
342
Token cost
~466 tokens
SKILL.md length
88 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

结构化的性能分析工作流。识别瓶颈、与性能预算对比测量,并生成带有优先级排序的优化建议. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

  • Works in 5 steps: 确定范围根据参数 → 读取性能预算 — 检查设计文档或 CLAUDE.md 中是否有现有性能目标 → 分析代码库中的常见性能问题 → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Perf Profile is an agent skill from pixel-cellar/Claude-Code-Game-Studios. 结构化的性能分析工作流。识别瓶颈、与性能预算对比测量,并生成带有优先级排序的优化建议。

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

The repository describes itself as: 48 协同代理管理独立游戏开发的 Claude Code 架构 (中文本地化版本). The licence is MIT.

Example prompts

  • “/perf-profile”

Requirements

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

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 确定范围根据参数
  2. 读取性能预算 — 检查设计文档或 CLAUDE.md 中是否有现有性能目标
  3. 分析代码库中的常见性能问题
  4. 生成性能分析报告
  5. 输出报告并附带摘要:前 3 个热点、相对于预算的估算余量,以及建议的下一步行动。

What it can do on your machine

Read from SKILL.md and the folder at commit 2c016ef. 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
    • Glob
    • Grep
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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 Profile loads about 466 tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 88 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Glob, Grep, Bash

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 pixel-cellar/Claude-Code-Game-Studios at commit 2c016ef, republished under its MIT licence (© pixel-cellar). 88 words, ~466 tokens.

Download SKILL.mdSave it as .claude/skills/perf-profile/SKILL.md (or your agent's skills folder).
name
perf-profile
description
结构化的性能分析工作流。识别瓶颈、与性能预算对比测量,并生成带有优先级排序的优化建议。
allowed-tools
Read, Glob, Grep, Bash
argument-hint
[系统名称 或 'full']
user-invocable
true

当此技能被调用时:

  1. 确定范围根据参数:

    • 如果是系统名称:专注于该特定系统的分析
    • 如果是 full:对所有系统进行全面分析
  2. 读取性能预算 — 检查设计文档或 CLAUDE.md 中是否有现有性能目标:

    • 目标 FPS(例如 60fps = 16.67ms 帧预算)
    • 内存预算(总量和按系统)
    • 加载时间目标
    • Draw Call 预算
    • 网络带宽限制(如果是多人游戏)
  3. 分析代码库中的常见性能问题:

    CPU 分析目标:

    • _process() / Update() / Tick() 函数 — 列出所有并估算开销
    • 大集合上的嵌套循环
    • 热路径中的字符串操作
    • 每帧代码中的分配模式
    • 未优化的游戏实体搜索/排序
    • 每帧执行的昂贵物理查询(射线检测、重叠检测)

    内存分析目标:

    • 大型数据结构及其增长模式
    • 纹理/资源内存占用估算
    • 对象池 vs 实例化/销毁模式
    • 泄漏的引用(应该释放但未释放的对象)
    • 缓存大小和淘汰策略

    渲染目标(如适用):

    • Draw Call 估算
    • 重叠透明物体导致的过度绘制
    • 着色器 (Shader) 复杂度
    • 未优化的粒子系统
    • 缺失 LOD (Level of Detail) 或遮挡剔除 (Occlusion Culling)

    I/O 目标:

    • 存档/读档性能
    • 资源加载模式(同步 vs 异步)
    • 网络消息频率和大小
  4. 生成性能分析报告:

    markdown
    ## 性能分析:[系统或全面]
    生成日期:[日期]
    
    ### 性能预算
    | 指标 | 预算 | 估算当前值 | 状态 |
    |------|------|-----------|------|
    | 帧时间 | [16.67ms] | [估算值] | [正常/警告/超标] |
    | 内存 | [目标] | [估算值] | [正常/警告/超标] |
    | 加载时间 | [目标] | [估算值] | [正常/警告/超标] |
    | Draw Call | [目标] | [估算值] | [正常/警告/超标] |
    
    ### 发现的热点
    | # | 位置 | 问题 | 预估影响 | 修复工作量 |
    |---|------|------|---------|-----------|
    | 1 | [文件:行号] | [描述] | [高/中/低] | [小/中/大] |
    | 2 | [文件:行号] | [描述] | [高/中/低] | [小/中/大] |
    
    ### 优化建议(按优先级排序)
    1. **[标题]** — [优化描述]
       - 位置:[文件:行号]
       - 预期收益:[估算值]
       - 风险:[低/中/高]
       - 方案:[实现方式]
    
    ### 快速见效(每个不到 1 小时)
    - [简单优化 1]
    - [简单优化 2]
    
    ### 需要进一步调查
    - [需要实际运行时分析来确定影响的领域]
  5. 输出报告并附带摘要:前 3 个热点、相对于预算的估算余量,以及建议的下一步行动。

规则
  • 不要先测量就优化 — 对性能的直觉是不可靠的
  • 建议必须包含预估影响 — "让它更快"不具有可操作性
  • 在目标硬件上进行分析,而不仅仅是开发机器
  • 区分 CPU 瓶颈、GPU 瓶颈和 I/O 瓶颈
  • 考虑最坏情况(最大实体数、最低配置硬件、最差网络条件)
  • 静态分析(本技能)识别候选;运行时分析确认

© pixel-cellar, 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-profile of pixel-cellar/Claude-Code-Game-Studios.

Open the folder on GitHubat commit 2c016ef

Compare with similar skills

Perf Profile 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 Profile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Perf Profile this skillpixel-cellar/Claude-Code-Game-Studios342—~466Automated safety check: NotesMIT
PlotJuggler 4 Perf ProfilingPlotJuggler/PlotJuggler6.2k—~1.6kAutomated safety check: NotesMPL-2.0
Perf Profilercomposio-community/awesome-claude-plugins1.9k—~182Automated safety check: PassNone
Profileccusage/ccusage19k—~430Automated safety check: PassCustom licence
Perf Profilerlaolaoshiren/claude-code-skills-zh878—~385Automated safety check: PassMIT
Game Performance ProfilerDonchitos/Claude-Code-Game-Studios26k—~2.5kAutomated safety check: NotesMIT

Similar skills

  • PlotJuggler 4 Perf Profiling

    PlotJuggler/PlotJuggler

    Guides CPU profiling of PlotJuggler 4 on Linux with perf: count first, record cheaply with LBR, then read per-thread, flat, flamegraph or time-window views.

    6.2k GitHub stars~1.6k tokensUpdated 7 days ago
    DevelopmentAuto-check: notes
  • Perf Profiler

    composio-community/awesome-claude-plugins

    A skill your agent uses when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence.

    1.9k GitHub stars~182 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Profile

    ccusage/ccusage

    Profiles ccusage performance. An agent skill from ccusage/ccusage.

    19k GitHub stars~430 tokensUpdated today
    Auto-check passed
  • Perf Profiler

    laolaoshiren/claude-code-skills-zh

    基于可复现基线和 profiler 证据分析性能问题。用于用户要求定位慢接口、慢任务、慢查询、内存或网络瓶颈,制定优化方案,或验证优化收益时;区分实测结论与静态推断,不虚构耗时和提升比例,生产环境操作需明确授权。

    878 GitHub stars~385 tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Game Performance Profiler

    Donchitos/Claude-Code-Game-Studios

    Finds performance bottlenecks, measures them against frame, draw-call and memory budgets, and ranks the optimization recommendations.

    26k GitHub stars~2.5k tokensUpdated 9 days ago
    Game DevelopmentAuto-check: notes
  • Cpu Profile

    ClickHouse/ClickHouse

    Profile a ClickHouse query using the sampling query profiler and system.tracelog.

    50k GitHub stars~1.9k tokensUpdated today
    DatabasesAuto-check: notes

More from pixel-cellar/Claude-Code-Game-Studios

All 23 skills in this repo
  • Patch Notes

    pixel-cellar/Claude-Code-Game-Studios

    从 git 历史记录、Sprint 数据和内部更新日志生成面向玩家的补丁说明。将开发者语言转化为清晰、有吸引力的玩家沟通内容。

    342 GitHub stars~498 tokensUpdated 6 mo ago
    Auto-check: notes
  • Setup Engine

    pixel-cellar/Claude-Code-Game-Studios

    配置项目的游戏引擎和版本。将引擎锁定到 CLAUDE.md 中,检测知识缺口,当版本超出 LLM 训练数据时通过 WebSearch 填充引擎参考文档。

    342 GitHub stars~1.5k tokensUpdated 6 mo ago
    Auto-check passed
  • Estimate

    pixel-cellar/Claude-Code-Game-Studios

    通过分析复杂度、依赖关系、历史速度和风险因素来估算任务工作量。生成包含置信水平的结构化估算. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~751 tokensUpdated 6 mo ago
    Auto-check passed
  • Release Checklist

    pixel-cellar/Claude-Code-Game-Studios

    生成全面的发布前验证清单,涵盖构建验证、合规要求、商店元数据和发布准备就绪情况. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~696 tokensUpdated 6 mo ago
    Auto-check passed
  • Retrospective

    pixel-cellar/Claude-Code-Game-Studios

    通过分析已完成的工作、速率、阻碍因素和模式来生成 Sprint 或里程碑回顾。产出可执行的洞见以指导下一次迭代. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~767 tokensUpdated 6 mo ago
    Auto-check passed
  • Sprint Plan

    pixel-cellar/Claude-Code-Game-Studios

    根据当前里程碑、已完成工作和可用产能生成新的冲刺计划或更新现有计划。从生产文档和设计待办事项中拉取上下文. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~481 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Perf Profile

What does Perf Profile do?

结构化的性能分析工作流。识别瓶颈、与性能预算对比测量,并生成带有优先级排序的优化建议. An agent skill from pixel-cellar/Claude-Code-Game-Studios. Perf Profile is an agent skill from pixel-cellar/Claude-Code-Game-Studios.

How do I install Perf Profile in Claude Code?

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

How do I install Perf Profile in Codex?

Run `npx skills add pixel-cellar/Claude-Code-Game-Studios --skill perf-profile -a codex`. Or copy the skill folder (.claude/skills/perf-profile in pixel-cellar/Claude-Code-Game-Studios) into .agents/skills/perf-profile in your project. Codex loads it when a task matches its description.

Can I use Perf Profile 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 pixel-cellar/Claude-Code-Game-Studios --skill perf-profile -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-profile, .gemini/skills/perf-profile, .github/skills/perf-profile and .opencode/skills/perf-profile in your project.

What does Perf Profile need to run?

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

Does Perf Profile 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 Profile safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Perf Profile use?

Perf Profile 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 Profile use?

About 466 tokens (SKILL.md is roughly 1.9k 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 Profile?

Skills that share tags, products or a category with Perf Profile: PlotJuggler 4 Perf Profiling (PlotJuggler/PlotJuggler, 6.2k stars), Perf Profiler (composio-community/awesome-claude-plugins, 1.9k stars), Profile (ccusage/ccusage, 19k stars) and Perf Profiler (laolaoshiren/claude-code-skills-zh, 878 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Perf Profile?

pixel-cellar (a GitHub organization) maintains it in pixel-cellar/Claude-Code-Game-Studios, which has 342 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on March 30, 2026.

Source: pixel-cellar/Claude-Code-Game-Studios on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.