Official agent skill

Workers Profiling

by cloudflare in cloudflare/skills

Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects.

OfficialApache-2.0Auto-check passed

Install Workers Profiling

skills CLI
$ npx skills add cloudflare/skills --skill workers-profiling -a claude-code

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

GitHub CLI
$ gh skill install cloudflare/skills workers-profiling --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/cloudflare/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/workers-profiling .claude/skills/workers-profiling && 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
workers-profiling
GitHub stars
3k
Token cost
~494 tokens
SKILL.md length
252 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects.

  • Works in 4 steps: Identify the symptom and affected… → Confirm the account, Worker,… → For a Durable Object, also confirm its… → …
  • SKILL.md covers Retrieve the docs, Profiling steps, Inspect the evidence and Optimise, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Workers Profiling is an agent skill from cloudflare/skills, published by the product's own GitHub organization. Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects. Then use this information to optimize your code.

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

It works with Cloudflare Durable Objects and Cloudflare Workers. The repository describes itself as: Skills for teaching agents how to build on Cloudflare. The licence is Apache-2.0.

Example prompts

  • “/workers-profiling”

Workflow steps

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

  1. Identify the symptom and affected workload: CPU usage, latency, allocation pressure, or memory growth.
  2. Confirm the account, Worker, environment, and deployed version with the user.
  3. For a Durable Object, also confirm its owning Worker, namespace, and instance.
  4. Choose CPU or heap profiling from the current guide's supported types and meanings.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

    Links to these hosts (documentation or services it may open):

    • developers.cloudflare.com

    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

Workers Profiling loads about 494 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 252 words of instructions outside code blocks.

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

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 cloudflare/skills at commit c430dd9, republished under its Apache-2.0 licence (© cloudflare). 252 words, ~494 tokens.

Download SKILL.mdSave it as .claude/skills/workers-profiling/SKILL.md (or your agent's skills folder).
name
workers-profiling
description
Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects. Then use this information to optimize your code.

Workers profiling

Find expensive functions or memory allocations in deployed code and come up with ways to fix them.

Retrieve the docs

Start with the production profiling guide to understand how Workers and Durable Objects profiling works.

Profiling steps

  1. Identify the symptom and affected workload: CPU usage, latency, allocation pressure, or memory growth.
  2. Confirm the account, Worker, environment, and deployed version with the user.
  3. For a Durable Object, also confirm its owning Worker, namespace, and instance.
  4. Choose CPU or heap profiling from the current guide's supported types and meanings.

Where possible, use the cf CLI to capture profiles. If the user requests cf, inspect the installed version's command help and schema where available.

If cf isn't available, consider prompting the user whether they would like to install it.

The profiling API will return a pprof file which you can analyze directly, or using appropriate tools like Go's pprof utility.

Inspect the evidence

  • Read the pprof file and analyse it for hotspots
  • Map hotspots to functions and source locations when evidence supports it; report missing symbols or source mappings.
  • If filenames and function names are pointing at the generated JavaScript, consider suggesting to the user to enable source maps and re-do the profiling.

Optimise

Propose the smallest code change supported by the capture which resolves the issues identified.

Report findings

Return a concise report with:

  • Evidence for each finding: file, function, source location, and metric with units, where available.
  • The smallest actionable change and how to check its effect.

© cloudflare, Apache-2.0. 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 skills/workers-profiling of cloudflare/skills.

Open the folder on GitHubat commit c430dd9

Compare with similar skills

Workers Profiling 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.

Workers Profiling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workers Profiling this skillcloudflare/skills3k—~494Automated safety check: PassApache-2.0
Cloudflarehodgef/apiker1277 repos~2.2kAutomated safety check: PassMIT
Durable Objectshodgef/apiker1274 repos~1.5kAutomated safety check: PassMIT
Cf Compatibility Checkelliothux/open-compute1.9k—~3.5kAutomated safety check: PassApache-2.0
Pairlanekiyo-e/pairlane152—~900Automated safety check: PassMIT
Sharehtml Collaborationjonesphillip/sharehtml133—~902Automated safety check: PassApache-2.0

Similar skills

  • Cloudflare

    hodgef/apiker

    Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF…

    127 GitHub starsUsed in 7 repos~2.2k tokens
    DevOps & CloudAuto-check passed
  • Durable Objects

    hodgef/apiker

    Create and review Cloudflare Durable Objects. An agent skill from hodgef/apiker.

    127 GitHub starsUsed in 4 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Cf Compatibility Check

    elliothux/open-compute

    Review branch and working-tree implementation changes for conformance with open-compute's Cloudflare Workers runtime target under explicit single-machine self-host exclusions.

    1.9k GitHub stars~3.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Pairlane

    kiyo-e/pairlane

    Use the Pairlane CLI through npx pairlane for peer-to-peer file transfers.

    152 GitHub stars~900 tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Sharehtml Collaboration

    jonesphillip/sharehtml

    A skill your agent uses when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI.

    133 GitHub stars~902 tokensUpdated 6 mo ago
    Auto-check passed
  • Cloudflare Workers

    danieljvdm/effect-cf

    Build, review, or operate Cloudflare Workers, Durable Objects, and Sandbox SDK applications with Wrangler.

    112 GitHub starsUsed in 1 repo~324 tokens
    Auto-check passed

More from cloudflare/skills

All 17 skills in this repo
  • Turnstile Spin

    cloudflare/skills

    Official

    Set up, repair, or migrate to Cloudflare Turnstile bot verification in an existing frontend and backend, including server-side Siteverify.

    3k GitHub starsUsed in 4 repos~7.2k tokens
    Auto-check: notes
  • Nextjs On Cloudflare

    cloudflare/skills

    Official

    Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.

    3k GitHub starsUsed in 2 repos~678 tokens
    Auto-check passed
  • Agents SDK

    cloudflare/skills

    Official

    Build, debug, or review Cloudflare Agents SDK applications using the agents package.

    3k GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • Basin

    cloudflare/skills

    Official

    Build and troubleshoot Cloudflare Basin analytics workflows with Basin Pipelines, Basin Catalog, and Basin SQL.

    3k GitHub starsUsed in 2 repos~684 tokens
    Auto-check passed
  • Durable Objects

    cloudflare/skills

    Official

    Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.

    3k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Cloudflare One Migrations

    cloudflare/skills

    Official

    Assess and plan migrations from existing VPN, SWG, or SASE platforms to Cloudflare One, including policy mapping, parity gaps, and rollout.

    3k GitHub starsUsed in 6 repos~3.1k tokens
    Auto-check passed

Questions about Workers Profiling

What does Workers Profiling do?

Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects. Workers Profiling is an agent skill from cloudflare/skills, published by the product's own GitHub organization. Profile or debug CPU usage and memory allocation in deployed Cloudflare Workers and Durable Objects.

How do I install Workers Profiling in Claude Code?

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

How do I install Workers Profiling in Codex?

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

Can I use Workers Profiling 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 cloudflare/skills --skill workers-profiling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workers-profiling, .gemini/skills/workers-profiling, .github/skills/workers-profiling and .opencode/skills/workers-profiling in your project.

What does Workers Profiling need to run?

SKILL.md names no scripts, command-line tools or credentials: Workers Profiling is instructions for the agent only.

Does Workers Profiling access the network?

SKILL.md names 1 domain. As links in the text: developers.cloudflare.com. This is read from the text; nothing was executed.

Is Workers Profiling 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 Workers Profiling use?

Workers Profiling is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workers Profiling use?

About 494 tokens (SKILL.md is roughly 2k 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 Workers Profiling?

Skills that share tags, products or a category with Workers Profiling: Cloudflare (hodgef/apiker, 127 stars), Durable Objects (hodgef/apiker, 127 stars), Cf Compatibility Check (elliothux/open-compute, 1.9k stars) and Pairlane (kiyo-e/pairlane, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workers Profiling?

cloudflare (a GitHub organization, an official publisher) maintains it in cloudflare/skills, which has 3,033 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 2026.

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