Agent skill

Run Aiperf Benchmark

by ai-dynamo in ai-dynamo/dynamo

Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics.

Apache-2.0Auto-check passedDevOps & Cloud

Install Run Aiperf Benchmark

skills CLI
$ npx skills add ai-dynamo/dynamo --skill run-aiperf-benchmark -a claude-code

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

GitHub CLI
$ gh skill install ai-dynamo/dynamo run-aiperf-benchmark --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/ai-dynamo/dynamo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/run-aiperf-benchmark .claude/skills/run-aiperf-benchmark && 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
run-aiperf-benchmark
GitHub stars
8.3k
Token cost
~1.3k tokens
SKILL.md length
577 words
Files
1
Skills in repo
27
Repo updated
First seen
Licence
Apache-2.0

At a glance

Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics.

  • Works in 5 steps: Apply the run-scoped Job. → Wait with a bounded timeout and coarse… → Monitor Job conditions, pod… → …
  • Tasks that involve Container orchestration
  • SKILL.md covers Preflight, Execute And Monitor, Debug By Ownership and Output Status
  • Calls kubectl

What it does

Run Aiperf Benchmark is an agent skill from ai-dynamo/dynamo. Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics. Use after perf.yaml and aiperf-config.yaml have been configured for a smoke-tested Dynamo deployment.

Its SKILL.md is about 1.3k 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 DevOps & Cloud, covering Container orchestration. It works with Kubernetes. The repository describes itself as: A Datacenter Scale Distributed Inference Serving Framework. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Container orchestration

Example prompts

  • “/run-aiperf-benchmark”

Workflow steps

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

  1. Apply the run-scoped Job.
  2. Wait with a bounded timeout and coarse polling.
  3. Monitor Job conditions, pod phase/restarts, recent events, and the relevant AIPerf log tail.
  4. On completion, copy the complete AIPerf output directory unchanged into
  5. Record exact commands, Job/pod names, start/end timestamps, configured and actual measurement duration, whether this

What it can do on your machine

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

    • kubectl

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

  • Network

    No URLs in SKILL.md. Its commands use kubectl, which can reach the network depending on how they are called.

    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

Run Aiperf Benchmark loads about 1.3k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 577 words of instructions outside code blocks.

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

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 ai-dynamo/dynamo at commit f54f2a4, republished under its Apache-2.0 licence (© ai-dynamo). 577 words, ~1,281 tokens.

Download SKILL.mdSave it as .claude/skills/run-aiperf-benchmark/SKILL.md (or your agent's skills folder).
name
run-aiperf-benchmark
description
Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics. Use after perf.yaml and aiperf-config.yaml have been configured for a smoke-tested Dynamo deployment.
license
Apache-2.0
metadata.author
NVIDIA
metadata.tags
dynamo, aiperf, benchmarking

Run AIPerf Benchmark

<!--
SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
SPDX-License-Identifier: Apache-2.0
-->

Execute the configured Job and preserve operational evidence. Do not interpret performance.

Read agent-docs/rules/execution/deployment.md, agent-docs/rules/execution/logging.md, agent-docs/rules/execution/run-artifacts.md, agent-docs/rules/benchmarking/benchmark-isolation.md, agent-docs/rules/benchmarking/comparison-uncertainty.md, agent-docs/rules/benchmarking/evidence-eligibility.md, agent-docs/rules/benchmarking/series-boundaries.md, and the exact active benchmark plan first.

Preflight

  • Confirm the selected Kubernetes context and namespace.
  • Verify the plan path, SHA256, series ID, and performance question against the run-scoped configuration.
  • Server-dry-run perf.yaml and verify its Job name from metadata.name.
  • Verify the frontend service is reachable in cluster and /v1/models exposes the configured served model.
  • Verify the AIPerf config, workload trace, tokenizer, PVC/mounts, image, and referenced secrets are available to the benchmark pod.
  • Confirm the AIPerf measurement is configured to finish in 30 minutes or less and uses one repetition by default.
  • For an additional valid-run repetition, require the prior analysis to record why the repeat is necessary and worth its GPU cost. Do not repeat only to obtain confidence intervals. The once-per-series noise-floor pilot (n=3) required by comparison-uncertainty.md is pre-authorized and arrives through the normal repeat_decision: necessary path with a rationale naming the series pilot; it needs no further justification.
  • Confirm no other benchmark is targeting the same candidate.
  • Every kubectl invocation this skill drives pins --context "${KUBE_CONTEXT}" and -n "${NAMESPACE}", bounds every wait with an explicit timeout, distinguishes job Failed from timeout (poll the job's true condition rather than waiting on Complete alone), and chains commands so a failure never flows into the next step — the same discipline deploy-dynamo-recipe's scripted blocks encode.
  • Record neighbour occupancy in benchmark_execution.json at run start and end (the pods scheduled on the serving nodes, e.g. kubectl --context "${KUBE_CONTEXT}" get pods -A -o wide filtered to those nodes), so comparison-uncertainty.md's like-for-like and transition checks have a recorded condition to read.

Execute And Monitor

  1. Apply the run-scoped Job.
  2. Wait with a bounded timeout and coarse polling.
  3. Monitor Job conditions, pod phase/restarts, recent events, and the relevant AIPerf log tail.
  4. On completion, copy the complete AIPerf output directory unchanged into <DEPLOY_ROOT>/benchmark/raw_aiperf/ before deleting the Job or pod.
  5. Record exact commands, Job/pod names, start/end timestamps, configured and actual measurement duration, whether this was the default run or an approved repeat, repeat rationale, AIPerf source/runtime versions, exit status, retry history, and artifact paths in benchmark_execution.json.
Show full SKILL.md (214 more words)Show less

Debug By Ownership

FailureAction
Endpoint, model, or deployed workload failureRecord a handoff to recipe-deployer; do not patch the DGD here
Invalid trace or AIPerf settingsReturn to configure-aiperf-benchmark
Repairable invalid evidenceConsume the audit blockers from analyze-aiperf-results, rerun the active series unchanged without overwriting prior raw artifacts, record the retry, then return to analyze-aiperf-results
Job scheduling, mount, image, or artifact-copy issueRepair only the run-scoped benchmark manifest and record why
AIPerf client/tool failureUse the pinned AIPerf docs/source, repair without changing benchmark semantics
Repeated identical failureStop and record the blocker

Do not reduce request count, remove difficult trace rows, relax SLOs, lower load, switch schedule mode, or alter ISL/OSL to make a failed benchmark finish. Such a change creates a different benchmark plan and comparison series. Do not launch another valid run because a small delta was classified as noise or because confidence intervals are absent.

Output Status

Set benchmark_execution.json.status to completed, failed, or blocked. A completed Job is not automatically a valid benchmark; validity belongs to the audit phase of analyze-aiperf-results. Record the exact benchmark-plan path, SHA256, series ID, and performance question in the execution record.

Keep logs only when they explain a failure beyond the concise execution ledger. Do not retain routine successful pod logs or broad cluster snapshots.

© ai-dynamo, 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 .agents/skills/run-aiperf-benchmark of ai-dynamo/dynamo.

Open the folder on GitHubat commit f54f2a4

Compare with similar skills

Run Aiperf Benchmark 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.

Run Aiperf Benchmark compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Aiperf Benchmark this skillai-dynamo/dynamo8.3k—~1.3kAutomated safety check: PassApache-2.0
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
KubeSphere Multi-Tenant Managementkubesphere/kubesphere17k—~3.1kAutomated safety check: PassCustom licence
Sim Helmsimstudioai/sim30k—~2.2kAutomated safety check: PassApache-2.0
Helm Chart ScaffoldingCybereason-Public/owLSM28013 repos~381Automated safety check: PassGPL-2.0
Kubeshark KFL2 Filter Referencekubeshark/kubeshark12k—~3.6kAutomated safety check: PassApache-2.0

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Creates and queries KubeSphere users, workspaces and projects and assigns built-in roles, defaulting to least privilege and never deleting anything.

    17k GitHub stars~3.1k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Sim Helm

    simstudioai/sim

    Install, upgrade, and operate the Sim Helm chart on Kubernetes.

    30k GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Helm Chart Scaffolding

    Cybereason-Public/owLSM

    Comprehensive guidance for creating, organizing, and managing Helm charts for packaging and deploying Kubernetes applications.

    280 GitHub starsUsed in 13 repos~381 tokens
    DevOps & CloudAuto-check passed
  • Syntax reference for KFL2, the CEL-based display filter language used to search Kubernetes network traffic captured by Kubeshark, loaded before any filter is written.

    12k GitHub stars~3.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed

More from ai-dynamo/dynamo

All 27 skills in this repo
  • Visual Review

    ai-dynamo/dynamo

    Create self-contained interactive HTML code-review dashboards from GitHub or GitLab pull requests, checked-out branch diffs, or supplied unified diffs, with correctness and safe-to-merge scores…

    8.3k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Fern Components

    ai-dynamo/dynamo

    Knowledge of Fern's built-in MDX component library (accordions, callouts, cards, steps, tabs, code blocks, API-reference snippets, and more) for authoring docs pages.

    8.3k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Fern Navigation

    ai-dynamo/dynamo

    Knowledge of Fern's site-level navigation and structure configuration — how a docs site is organized in docs.yml (and product/version .yml files) using sections, pages, folders, tabs, tab variants…

    8.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Dynamo Agent Harness

    ai-dynamo/dynamo

    Drives persistent Claude Code, Codex, or OpenCode agent sessions through a Dynamo OpenAI/Anthropic-compatible endpoint over Agent Client Protocol (ACP).

    8.3k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Benchmark and profile the Dynamo frontend (dynamo.frontend HTTP + tokenizer + KV router) against mock workers (dynamo.mocker).

    8.3k GitHub stars~3.5k tokensUpdated today
    Auto-check: notes
  • Selects and freezes a question-driven AIPerf workload, objective, load policy, and Kubernetes execution manifest for a successfully deployed Dynamo candidate.

    8.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Run Aiperf Benchmark

What does Run Aiperf Benchmark do?

Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics. Run Aiperf Benchmark is an agent skill from ai-dynamo/dynamo. Launches, monitors, debugs, and collects one run-scoped AIPerf Kubernetes benchmark without changing its workload semantics.

When should I use Run Aiperf Benchmark?

Run Aiperf Benchmark fits situations like: tasks that involve Container orchestration.

How do I install Run Aiperf Benchmark in Claude Code?

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

How do I install Run Aiperf Benchmark in Codex?

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

Can I use Run Aiperf Benchmark 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 ai-dynamo/dynamo --skill run-aiperf-benchmark -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-aiperf-benchmark, .gemini/skills/run-aiperf-benchmark, .github/skills/run-aiperf-benchmark and .opencode/skills/run-aiperf-benchmark in your project.

What does Run Aiperf Benchmark need to run?

Going by SKILL.md and its folder, Run Aiperf Benchmark needs the command-line tools its instructions call (kubectl).

Does Run Aiperf Benchmark 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 Run Aiperf Benchmark 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 Run Aiperf Benchmark use?

Run Aiperf Benchmark is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Aiperf Benchmark use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Run Aiperf Benchmark?

Skills that share tags, products or a category with Run Aiperf Benchmark: Kubeshark Installer (kubeshark/kubeshark, 12k stars), KubeSphere Multi-Tenant Management (kubesphere/kubesphere, 17k stars), Sim Helm (simstudioai/sim, 30k stars) and Helm Chart Scaffolding (Cybereason-Public/owLSM, 280 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Aiperf Benchmark?

ai-dynamo (a GitHub organization) maintains it in ai-dynamo/dynamo, which has 8,250 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 9, 2026.

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