Agent skill

Profile

by ccusage in ccusage/ccusage

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

Custom licenceAuto-check passed

Install Profile

skills CLI
$ npx skills add ccusage/ccusage --skill profile -a claude-code

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

GitHub CLI
$ gh skill install ccusage/ccusage 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/ccusage/ccusage.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/profile .claude/skills/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
profile
GitHub stars
19k
Token cost
~430 tokens
SKILL.md length
190 words
Files
3 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • A CLI command is slow
  • Calls node and nix
  • Checking that an optimization actually helped
  • Comparing a branch against main

What it does

Profile is an agent skill from ccusage/ccusage. Profiles ccusage performance. Use when a CLI command is slow, when checking that an optimization actually helped, when comparing a branch against main, or when reading a captured CPU profile.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/rust.md`).

When your agent uses it

  • A CLI command is slow
  • Checking that an optimization actually helped
  • Comparing a branch against main
  • Reading a captured CPU profile

Example prompts

  • “Use the profile skill to profile ccusage performance. An agent skill from ccusage/ccusage”
  • “/profile”

What it can do on your machine

Read from SKILL.md and the folder at commit d2fd844. 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

    Shell commands in SKILL.md call:

    • node
    • nix

    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

Profile loads about 430 tokens when it runs, and up to ~940 if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 190 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~430
With references · SKILL.md plus every file in references/, read only if the agent opens them
~940

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 190 words (~430 tokens).

“Nearly all runtime cost lives in the Rust binary. references/rust.md covers release builds, the branch-vs-main worktree setup, deterministic measurement, JSON parity, and reproducing the CI performance comment.”

— opening of SKILL.md by ccusage, Custom licence
name
profile

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .agents/skills/profile of ccusage/ccusage.

  • SKILL.md
  • agents/openai.yaml
  • references/rust.md

Open the folder on GitHubat commit d2fd844

Compare with similar skills

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.

Profile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Profile this skillccusage/ccusage19k—~430Automated safety check: PassCustom licence
Codex Profilessickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: PassMIT
Profiling Slow API EndpointsPostHog/posthog-foss721—~1kAutomated safety check: PassMIT
Collectors Snmp Profilesnetdata/netdata81k—~3.1kAutomated safety check: PassGPL-3.0
Competitor Profilingsickn33/agentic-awesome-skills47k1 repos~3.6kAutomated safety check: PassMIT
Mz ProfileMaterializeInc/materialize6.4k—~480Automated safety check: PassCustom licence

Similar skills

  • Codex Profiles

    sickn33/agentic-awesome-skills

    Use codex-profiles to run Codex CLI or Codex Desktop with isolated CODEXHOME profiles for separate accounts, projects, and local state.

    47k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Profiling Slow API Endpoints

    PostHog/posthog-foss

    Official

    Profiles slow PostHog API endpoints when the main cost is in Postgres or Python.

    721 GitHub stars~1k tokensUpdated today
    DatabasesAuto-check passed
  • Author or review Netdata SNMP polling profiles, ddsnmp parsing, topology/licensing/BGP rows and profile-format documentation.

    81k GitHub stars~3.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Competitor Profiling

    sickn33/agentic-awesome-skills

    When the user wants to research, profile, or analyze competitors from their URLs.

    47k GitHub starsUsed in 1 repo~3.6k tokens
    Marketing & SEOAuto-check passed
  • Mz Profile

    MaterializeInc/materialize

    Trigger: "profile Materialize", "check memory usage", "analyze binary size", "debug performance", or mentions profiling, samply, heaptrack, flame graphs, memory checking, binary size, slow queries…

    6.4k GitHub stars~480 tokensUpdated today
    DevelopmentAuto-check passed
  • Generate Profile

    sgl-project/sglang

    Generate an e2e profiling trace of an SGLang server run. An agent skill from sgl-project/sglang.

    37k GitHub starsUsed in 2 repos~1.1k tokens
    Testing & QAAuto-check passed

More from ccusage/ccusage

All 17 skills in this repo
  • Nushell

    ccusage/ccusage

    Guides ccusage Nushell scripts. An agent skill from ccusage/ccusage.

    19k GitHub stars~938 tokensUpdated today
    Auto-check passed
  • Rust Binary Size

    ccusage/ccusage

    Guides Rust binary size reduction for ccusage. An agent skill from ccusage/ccusage.

    19k GitHub stars~591 tokensUpdated today
    Auto-check passed
  • Skill Creator

    ccusage/ccusage

    Guides repo-local skill creation and updates. An agent skill from ccusage/ccusage.

    19k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • TDD

    ccusage/ccusage

    Guides t-wada Red-Green-Refactor TDD for ccusage logic changes.

    19k GitHub stars~665 tokensUpdated today
    Auto-check passed
  • Commit

    ccusage/ccusage

    Creates atomic Conventional Commits. An agent skill from ccusage/ccusage.

    19k GitHub stars~722 tokensUpdated today
    Auto-check passed
  • Create PR

    ccusage/ccusage

    Runs the full PR lifecycle. An agent skill from ccusage/ccusage.

    19k GitHub stars~646 tokensUpdated today
    Auto-check passed

Questions about Profile

What does Profile do?

Profiles ccusage performance. An agent skill from ccusage/ccusage. Profile is an agent skill from ccusage/ccusage. Profiles ccusage performance.

When should I use Profile?

Profile fits situations like: A CLI command is slow; checking that an optimization actually helped; comparing a branch against main; reading a captured CPU profile.

How do I install Profile in Claude Code?

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

How do I install Profile in Codex?

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

Can I use 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 ccusage/ccusage --skill 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/profile, .gemini/skills/profile, .github/skills/profile and .opencode/skills/profile in your project.

What does Profile need to run?

Going by SKILL.md and its folder, Profile needs the command-line tools its instructions call (node and nix).

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

Profile has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Profile use?

About 430 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 510 tokens, read only when the agent opens those files.

What are the alternatives to Profile?

Skills that share tags, products or a category with Profile: Codex Profiles (sickn33/agentic-awesome-skills, 47k stars), Profiling Slow API Endpoints (PostHog/posthog-foss, 721 stars), Collectors Snmp Profiles (netdata/netdata, 81k stars) and Competitor Profiling (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Profile?

ccusage (a GitHub organization) maintains it in ccusage/ccusage, which has 18,901 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

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