Warp Eval
NVIDIAOfficialCreated by NVIDIA Corporation
- Skill
- Workflow
- Software development
- Apache-2.0
- Medium risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The warp-eval skill provides a structured, evidence-based methodology to determine if specific hot paths in an existing codebase are viable candidates for NVIDIA Warp. It emphasizes objective reporting over recommendations, requiring users to define clear performance metrics and semantic contracts before any prototyping occurs. The process includes static screening, rigorous baseline comparisons, and authorized benchmarking, ensuring that Warp is only considered after in-project alternatives have been exhausted. The skill enforces strict gates to abort evaluations that do not meet technical or policy requirements, ensuring that only credible candidates proceed to measurement.
What it does
- Screens code bottlenecks against specific technical gates to determine Warp suitability.
- Requires the establishment of a semantic contract and performance baseline before prototyping.
- Enforces a ladder of in-project optimizations to be exhausted before introducing Warp.
- Produces a standardized evaluation report containing measurements, evidence, and caveats.
- Ensures all performance claims are backed by synchronized, end-to-end measurements.
- Provides scripts for synchronized timing, memory profiling, and report validation.
When to use it
- When investigating performance bottlenecks involving irregular queries, simulations, or branch-heavy loops.
- When you need to objectively assess if Warp provides a measurable benefit over existing in-project baselines.
- When you require a reproducible, audit-ready report on potential GPU acceleration candidates.
- When you need to determine if a performance issue is material enough to warrant a new dependency.
Advantages
- Prevents premature optimization by requiring algorithmic improvements first.
- Provides a clear, objective framework to stop evaluations that are not technically viable.
- Ensures performance measurements include realistic overheads like JIT, transfers, and synchronization.
- Maintains production code integrity by working in isolated, independent patches.
- Standardizes the reporting of facts, hypotheses, and unknowns.
Usage examples
- “Evaluate if the particle simulation loop in my project is a good candidate for Warp.”
- The agent will identify the candidate seam, derive the contract, check initial gates, and provide a resource preview before asking for authorization to proceed with profiling.
- “I have a performance bottleneck in my geometry processing code; can you run a warp-eval?”
- The agent will initiate the screening process, request the target repository, and begin identifying candidate patterns to determine if a formal evaluation is warranted.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/nvidia/warp-eval/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip warp-eval.zip -d .agents/skills
Documentation by NVIDIA Corporation
Warp evaluation
Purpose
Collect reproducible evidence about how a narrow seam in an existing codebase would behave in NVIDIA Warp. Report facts; the user decides.
Name Warp as the option under evaluation in the first line, state that no adoption recommendation will follow, and do not treat the triggering performance request as authorization to experiment.
Measured evaluations produce warp-evaluation-report/: the report, one
independently applicable diff per solution, the drivers, and raw results. Never
modify production code. Exits before measured work create no directory.
Hard rules
These override any local reasoning.
Default objectives are latency, throughput, and peak or retained memory. Count maintainability, ergonomics, packaging, extensibility, autodiff or new functionality only when the user names it; otherwise report them as constraints or costs, not benefits.
Correctness is a gate. If the incumbent is buggy or its contract unclear, abort that comparison until an independent oracle or clarified contract exists. Report the defect without prescribing a response.
Never predict savings from source shape or another workload. Materialized memory comes from profiler or allocator evidence, not source a compiler may fuse.
"It can be written in Warp" is a hypothesis, never a proven opportunity.
Gates are exact, never adjacent or analogous. Fire a gate only when every condition in its definition is established. Gate D requires a maintained implementation confirmed to execute with CUDA on an NVIDIA GPU; a fast native CPU library is a baseline, not Gate D.
Label every claim as observed fact, measurement, hypothesis or unknown.
Time the user-visible stage, not the kernel. Include Warp's cold import/init/JIT in the real process regime, transfers, launches, Python launch loops, structure build/refit, allocation, conversion, validation, compaction and synchronization. Report each cost and the end-to-end difference.
No measured work without explicit authorization. After stage 1, stop and ask before profiling, environment changes, prototyping, benchmarking or GPU use.
Authorized measured work includes Warp. If profiling exposes no gate, continue through the strongest in-project baseline, minimum Warp prototype and end-to-end comparison. If Warp is out of scope, stop before profiling.
Never infer environment intent. NVIDIA deployment and ownership of an optional compiled dependency are product decisions. Abort only on a stated constraint; otherwise ask once and stop (
AWAITING INTENT).Warp measurements are CUDA-only and synchronized. Resolve an explicit NVIDIA CUDA device; discard CPU resolution and dispatch-only timing.
Never recommend or rank adoption options. Report facts, measurements, hypotheses and unknowns per seam and regime.
Stop at the report. No rollout or production edits.
Requirements
Static screening requires the target repository and its stated product constraints. Measured work additionally requires explicit authorization, an NVIDIA CUDA GPU, target-project dependencies and a representative workload.
Limitations
Warp CPU kernels are serial and outside this skill's evaluation scope. "Run it on the CPU instead" is not a performance fallback.
Mesh and geometry queries compute in float32/int32 even behind a float64 public API. Absolute error grows with coordinate magnitude.
Warp does not follow semver. Feature releases can break APIs, only the newest feature line is maintained, deprecations run roughly four monthly releases.
latestdocs track development, not the shipped release. Pin to the target project's own Warp version; if it has none, use the current stable and say which.Kernel-only builtins are not resolvable from Python —
hasattr(wp, "mesh_query_point")isFalseon a release that has it. Probe the stub file or that version's docs before concluding a builtin is absent.enable_backward=False(kernel, module or global) removes adjoint codegen. If nothing differentiates through the seam, set it before measuring compile cost.
Output Format
| State | Reached when | Report directory |
|---|---|---|
ABORT | Any gate establishes that the evaluated seam cannot satisfy the stated scope | No if nothing was measured; otherwise preserve the evidence already collected |
AWAITING INTENT | The environment gates turn on a fact only the user has | No — one question, both branches concrete |
AWAITING AUTHORIZATION | A candidate pattern survives stage 1 | No — early findings plus scope/resource preview |
INCOMPLETE | Authorized work cannot obtain representative evidence required for the scoped evaluation | Yes — preserve collected evidence and name the one missing artifact |
| Report delivered | Authorized work produced measurements, or stopped after the report directory existed | Yes — facts per seam and regime, with missing evidence explicit |
Use this exact shape for an early exit:
ABORT — Gate <letter>: <cited fact>; <why the scoped Warp evaluation cannot proceed>.
Do not name a preferred alternative.
Reporting rules:
references/evidence-and-reporting.md.
A delivered directory follows the template's fixed order: schema and provenance,
authorization and evaluation state, stage census, one B<n> evidence section
per seam/regime, caveats, then environment/reproduction. solutions/,
benchmarks/ and results/ contain every linked artifact.
Examples
Gate exit: ABORT — Gate A: deployment.md requires one implementation with AMD, Apple and NVIDIA parity; a Warp-specific path cannot satisfy this scope.
Surviving candidate: Name the seam and pattern, label inferred facts as assumptions, state that no gate has fired, preview the profile/baseline/Warp prototype/benchmark scope and its cost, then ask the separate intent and authorization questions from references/authorization-checkpoint.md.
Inputs
Required: the target repository and a performance, memory or scale problem with a candidate seam. Optional: explicit deployment/packaging constraints, existing profiles or logs, representative datasets and acceptance criteria. Prompt constraints take precedence over repository policy/configuration, then existing logs. User corrections override inference. Never substitute an assumption for a stated fact or measurement.
Available scripts
| Script | Purpose | Arguments |
|---|---|---|
scripts/driver-template.py | Copy once per bottleneck; define workloads and variants | Edit placeholders, then run the copied driver |
scripts/measure.py | Import from drivers for synchronized timing, memory and isolated cases | Python API; do not execute directly |
scripts/validate_report_schema.py | Validate the delivered report and evidence links | <report-directory> |
Use run_script("scripts/validate_report_schema.py", args=["warp-evaluation-report"])
when supported; otherwise invoke the script with Python and the report directory.
Troubleshooting
No representative workload: mark the scope
INCOMPLETEand name the missing artifact; do not invent data or fire Gate F.Warp resolves to CPU or no CUDA device: discard the run and stop before correctness or timing claims.
Report validation fails: fix the report or referenced artifact; never waive the schema error.
Instructions
Every stage before the last can end the evaluation. Stop as soon as a gate fires; do not gather evidence that cannot change the scoped facts.
1. Read the code, derive the contract, check the gates
Identify a candidate and its metric with references/target-patterns.md.
Derive devices/residency, dtypes/shapes, sizes, frequency, process lifetime, gradients and packaging from the repository. Infer before asking.
State the inferred contract in one line and invite correction. Unknown hardware, counts, sizes and tolerances are assumptions, never measurements. Every inference remains open to correction and cannot satisfy a gate that requires a stated fact or measurement.
Check Gates A–E before profiling. Check Gate F now only if representative evidence already exists; otherwise carry it into stage 2. Every gate uses only the exact boundaries in references/rejection-gates.md.
| Gate | Fires when |
|---|---|
| A | Production is stated CPU-only or to need non-NVIDIA portability, with no acceptable optional CUDA path |
| B | Data must cross the host/device boundary per small or infrequent call and the boundary cannot be widened |
| C | The region is dense tensor algebra already mapped to a tuned framework or vendor library |
| D | A mature CUDA implementation already meets the contract, and no non-performance objective was requested |
| E | A stated policy blocks Warp's dependency, compilation, cache or fallback obligations |
| F | Representative evidence proves the region too small a share of its requested metric for any backend to move it |
Gate F can fire in stage 1 only from representative evidence that already exists — a supplied profile, structural bound, or arithmetic on figures the user quoted. If that evidence does not exist, Gate F remains open until stage 2 profiling; inferred values never fire it.
Gates A and E need a stated constraint. A CPU implementation, another accelerator, no Warp dependency, or a small dependency list proves nothing.
When A/E are unresolved and a pattern survives, ask whether an optional NVIDIA path is acceptable: named extra, soft import, existing fallback, default install unchanged. Every affirmative answer must say explicitly that Warp will be prototyped and benchmarked; conditions constrain only that Warp scope. A negative or undecided answer means
ABORT.Do not ask when another gate fired, the repository answers, or no pattern matched. No pattern means no profiling.
If a candidate survives, combine any intent question with the authorization checkpoint — early findings, exact scope, stages, resource cost — then stop. Stage 2 requires both settled intent and explicit authorization.
2. Profile the real application
Requires explicit authorization and a settled intent question.
Profile with the project's own profiler and representative entry points.
Measure synchronized end-to-end stage time and peak memory before choosing a backend. Report which entry points were profiled and which a gate screened.
Prioritize further measurement by observed cost, not source appearance.
Name each measurement by the public method and variant actually invoked. A fallback is an execution regime of that public seam, not a different operation, and a cheaper sibling method cannot screen out the named method.
Confirm the timed branch ran on the intended device. Unchanged cost and near-zero device allocation between host and device inputs exposes a host fallback.
Measure the stage's free-stage ceiling and stubbed floor through the public boundary. Do not subtract per-op timings.
If the measured ceiling proves the candidate cannot move its own metric,
ABORTthe affected scope under Gate F, preserve the evidence already collected, and stop. The existing authorization already covered this materiality check; do not ask for authorization again.If representative coverage is unavailable — no representative dataset, runnable entry point or production distribution — record the single missing artifact, mark the affected scope
INCOMPLETE, and stop. This is missing evidence, not Gate F and notABORT. An invented workload cannot prove materiality.
Protocol: references/benchmark-protocol.md.
3. Form falsifiable hypotheses
Record per candidate: source, bottleneck evidence, objective, narrow seam, mechanism Warp could change, strongest incumbent, risks, acceptance threshold, cheapest falsifying experiment. Screen against references/target-patterns.md; if none survives, write the report and stop.
4. Write the contract before the prototype
Define values, dtypes, shapes, devices, errors, mutation, ordering, ties, capacity/overflow, topology/degeneracy, tolerances, required gradients, streams, ownership, aliasing, invalidation, concurrency, capture, teardown and fallback.
Fix tolerances before seeing Warp output. Never weaken a contract after a mismatch.
ABORTbefore prototyping if the proposed seam cannot satisfy a required contract.Pre-register, before timing: workload provenance, the state variable and production range controlling cost, tuning knobs, incumbent run-to-run spread, and the oracle applied to every implementation.
Hazards and adversarial checks: references/semantic-contract.md.
5. Improve the baseline first
Algorithm before backend: (1) a better or output-sensitive algorithm; (2) chunking, tiling, sparse output, layout, rematerialization; (3) the incumbent framework's compiler and native primitives; (4) what the project already depends on — its own accelerator backend, a parallel idiom it ships but leaves off, or a capability an existing dependency exposes and nobody wired up; (5) only then narrow Warp.
Compare only in-scope options: the improved incumbent, capabilities reachable through current dependencies, and Warp. Do not add unrelated libraries.
Search declared dependencies for dormant backends, flags and bindings before calling a route absent.
Keep the improved incumbent as the oracle. A result against an untuned, incorrect or asymptotically inferior baseline does not establish a backend comparison.
Close every in-project route before prototyping Warp:
| State | What it takes to claim it |
|---|---|
| measured | timed through the same boundary as the baseline |
| absent | a cited declaration, symbol table or missing flag proves it is unavailable |
| waived | you asked the user and they chose to skip it; record their words |
A capability present but unbound is reachable, not absent. If exposing it costs no more than the planned Warp seam, measure it first. Ladder details: references/baselines.md. Waived routes do not block stage 6; every route not explicitly waived must be measured or evidenced absent before the Warp prototype begins.
6. Prototype the minimum unit
Work in a separate copy, production unchanged, integration seam off by default. Prototype only enough to test the hypothesis.
Select an explicit CUDA device for every Warp prototype and verify that Warp resolves it as CUDA before correctness or performance work. Never exercise or report Warp's CPU backend.
Size the unit by shared data and structure lifetime, not function boundaries: build/refit/query costs that amortize together are one unit.
Name variants before timing. Preserve each solution as an independent patch against the pinned baseline, and prove it applies cleanly and reproduces the measured result.
Surface unsupported cases and overflow before timing.
Run the adversarial contract checks, audit correctness at production scale, and deliberately break a branch to prove the tests fail. Any failed required check returns
ABORTfor the affected scope.Before treating a disappointing compute-bound or reuse-heavy result as representative, consider the stronger formulations in references/target-patterns.md. One naive kernel does not bound Warp's potential.
7. Benchmark the whole boundary
Copy scripts/driver-template.py once per bottleneck and measure through scripts/measure.py. Do not hand-roll timing or memory.
Warp launches are asynchronous. The measurement helper must synchronize the selected device immediately before starting and after enqueueing every timed region, before stopping its wall timer.
Include every rule-7 cost, the public call, the immediate downstream stage, realistic sizes, and cold/warm process regimes.
Transcribe every report cell from emitted JSON; absent records read
not measured.Report
null_test, and one-time costs both separately and amortized. Serialize GPU measurements under an exclusive device lock. Below 1.5× is no measured difference.ABORTfor a seam and regime whose predeclared end-to-end performance or memory requirement fails, after preserving the measurements.
Full protocol: references/benchmark-protocol.md.
8. Summarize the evidence
Per seam and execution regime, report semantic results, strongest-baseline measurements, workload provenance, time, memory, lifecycle, portability and ownership facts.
Use
pass,fail,not measured,not available,no representative data,unknownorn/aonly where a stated criterion makes that status objective. Missing evidence remains missing.Mark the report
completeonly when every evaluated seam and regime includes an end-to-end Warp measurement. Useaborted — <gate and scope>when a gate fired, orincomplete — <missing evidence and scope>when representative evidence was unavailable. Preserve everything collected. Never deliver an incumbent-only report as a completedwarp-eval.Give every stage worth ≥10 % of the measured total a census row with a status and a one-line reason, including the screened-out stages.
Check each gate against the metric that candidate's pattern exhausts, not the study's headline objective.
9. Hand back
Use assets/warp-evaluation-report-template.md unchanged in schema. Record authorization and scope.
One table per bottleneck: baseline, current-dependency solutions, then Warp; absolute time and peak memory, ratios, contract status, evidence gaps.
Include prose only where it explains the measurements or their bounds. Working artifacts belong in
results/.
uv run python scripts/validate_report_schema.py <report-directory>Run the validator once the first measurement establishes a census/table, and again before delivery. Fix every error.
Verify builds and imports from artifacts, not exit status. Ship the exact drivers run. Then stop.
Files
- ATTRIBUTION.mdAdded by AutoGineer897 B
- BENCHMARK.md4.3 KiB
- LICENSELicence file added by AutoGineer11.2 KiB
- SKILL.md19.2 KiB
- assets/warp-evaluation-report-template.md5.8 KiB
- config/skillspector-baseline.yaml475 B
- evals/evals.json22.3 KiB
- evals/files/gate-a-required-portability/deployment.md638 B
- evals/files/gate-a-required-portability/neighbors.pyScript872 B
- evals/files/gate-b-unwidenable-host-boundary/architecture.md794 B
- evals/files/gate-b-unwidenable-host-boundary/scoring.pyScript880 B
- evals/files/gate-c-dense-vendor-lowered/feature_stage.pyScript615 B
- evals/files/gate-d-cpu-incumbent-not-cuda/baseline.md472 B
- evals/files/gate-d-cpu-incumbent-not-cuda/operation_api.pyScript440 B
- evals/files/gate-d-mature-incumbent/baseline.md960 B
- evals/files/gate-d-mature-incumbent/contact_api.pyScript948 B
- evals/files/gate-e-runtime-obligations-forbidden/candidates.pyScript735 B
- evals/files/gate-e-runtime-obligations-forbidden/packaging-policy.md845 B
- evals/files/gate-f-immaterial-stage/profile.json603 B
- evals/files/gate-f-immaterial-stage/spatial_filter.pyScript646 B
- evals/files/pattern-fused-edge-intermediate/context.md742 B
- evals/files/pattern-fused-edge-intermediate/message_passing.pyScript521 B
- evals/files/pattern-sequential-recurrence/adaptive_filter.pyScript462 B
- evals/files/pattern-sequential-recurrence/context.md596 B
- evals/files/proceed-persistent-mesh-query/context.md767 B
- evals/files/proceed-persistent-mesh-query/queries.pyScript804 B
- references/authorization-checkpoint.md3.8 KiB
- references/baselines.md12.2 KiB
- references/benchmark-protocol.md16.3 KiB
- references/evidence-and-reporting.md7.2 KiB
- references/rejection-gates.md8.2 KiB
- references/semantic-contract.md13.3 KiB
- references/target-patterns.md16.3 KiB
- scripts/driver-template.pyScript3.4 KiB
- scripts/measure.pyScript20.8 KiB
- scripts/validate_report_schema.pyScript13.5 KiB
- skill-card.md4.4 KiB
- skill.oms.sig12.5 KiB
evals/evals.json
{
"skill_name": "warp-eval",
"evals": [
{
"id": "trigger-spatial-hot-path",
"prompt": "Our molecular preprocessing service spends most of its time in a Python loop that checks nearby 3D particles and builds a variable-length contact list. At production size it scans about two million particles and runs out of memory when we increase the cutoff. Find opportunities to make this narrow stage faster and reduce its memory footprint.",
"expected_output": "The agent activates warp-eval and begins a neutral Warp evaluation.",
"expected_skill": "warp-eval",
"assertions": [
"The agent reads the warp-eval SKILL.md.",
"The first line names NVIDIA Warp as the option being evaluated and makes clear that the skill will report evidence without an adoption recommendation.",
"The agent does not predict a speedup or memory reduction from the prompt alone.",
"The agent does not profile, install dependencies, prototype, benchmark, or use a GPU without the skill's explicit authorization checkpoint.",
"Any authorized measured evaluation includes the strongest in-project baseline, a Warp prototype, and an end-to-end Warp benchmark unless a gate aborts first."
]
},
{
"id": "trigger-cpu-only-is-current-state",
"prompt": "This service is all CPU NumPy today. Its bottleneck is a per-point closest-triangle search over a static mesh, repeated for millions of query points. Could this stage be accelerated without rewriting the rest of the service?",
"expected_output": "The agent activates warp-eval because CPU-only code and the absence of an existing GPU dependency do not by themselves rule out an optional NVIDIA path.",
"expected_skill": "warp-eval",
"assertions": [
"The agent reads the warp-eval SKILL.md.",
"The agent treats the repeated closest-triangle query as a plausible Warp-shaped candidate.",
"The agent does not treat the current CPU-only implementation, missing CUDA code, or missing Warp dependency as a rejection gate.",
"The agent does not claim that an NVIDIA deployment or optional compiled dependency is acceptable without evidence.",
"Every affirmative intent choice explicitly says Warp will be prototyped and benchmarked; the agent does not offer incumbent-only profiling as a warp-eval branch."
]
},
{
"id": "trigger-contribution-policy-is-not-deployment-policy",
"prompt": "Our branch-heavy connected-components pass is slow. Can you assess practical ways to speed it up? The contributing guide says new compiled dependencies require maintainer discussion and are unlikely to be merged.",
"expected_output": "The agent activates warp-eval and does not mistake contribution-process friction for a product constraint that rules out Warp.",
"expected_skill": "warp-eval",
"assertions": [
"The agent reads the warp-eval SKILL.md.",
"The agent recognizes branch-heavy connected-components work as potentially relevant to the assessment.",
"The agent does not reject Warp solely because dependency additions require discussion or may be hard to merge.",
"The agent keeps dependency ownership as an unresolved product fact unless stronger project context states a prohibition."
]
},
{
"id": "trigger-cross-vendor-context",
"prompt": "Earlier in this session we established that this library promises one accelerated implementation with feature and performance parity across NVIDIA, AMD, and Apple hardware; vendor-specific fast paths are not allowed. Given that constraint, find opportunities to speed up its irregular neighbor search.",
"expected_output": "The agent does not activate warp-eval because the session context explicitly requires accelerated cross-vendor parity and forbids an optional NVIDIA-specific path.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response honors the previously stated cross-vendor requirement rather than proposing Warp.",
"The response may suggest a portable algorithm or cross-vendor framework, but it does not start a Warp evaluation."
]
},
{
"id": "trigger-plain-numpy-optimization",
"prompt": "Can this NumPy be optimized? `dist = np.sqrt(np.sum((points - center) ** 2, axis=1)); return dist.mean()` The array has about 20,000 rows and this is called once when a report is generated.",
"expected_output": "The agent answers as an ordinary NumPy optimization question and does not activate warp-eval.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response stays focused on the NumPy expression, its allocation behavior, or whether optimization is material.",
"The response does not begin a Warp evaluation workflow."
]
},
{
"id": "trigger-dense-framework-layer",
"prompt": "Our PyTorch vision model spends time in a stack of convolutions, layer normalization, and matrix multiplies already running on an H100. Find opportunities to reduce inference latency.",
"expected_output": "The agent does not activate warp-eval for dense neural-network layers already handled by PyTorch and vendor libraries.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response keeps the work in PyTorch, its compiler, or tuned vendor libraries unless evidence identifies a genuinely custom operation.",
"The response does not recommend a Warp port for the named dense layers."
]
},
{
"id": "trigger-array-api-question",
"prompt": "In the simulation library we're using, what is the difference between a dense array and an indexed array view, and when can each be passed to a kernel?",
"expected_output": "The agent answers the array API question without activating the Warp evaluation skill.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response answers the API semantics directly.",
"The response does not start an evaluation, ask about deployment intent, or produce an adoption recommendation."
]
},
{
"id": "trigger-already-chosen-kernel-implementation",
"prompt": "Our PyTorch project already uses custom CUDA extensions, and this path has been approved as a CUDA kernel. Implement `triangle_aabbs(vertices, faces, out)`, where vertices is float32 `[N, 3]`, faces is int32 `[M, 3]`, and out is float32 `[M, 6]` containing each triangle's minimum and maximum coordinates.",
"expected_output": "The agent implements the already-chosen CUDA kernel without activating warp-eval.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response treats CUDA as already decided and focuses on a correct triangle-AABB implementation and launch.",
"The response does not reopen the backend-adoption decision or run an evaluation workflow."
]
},
{
"id": "trigger-explicit-cpu-only-requirement",
"prompt": "This command must keep running on CPU-only edge systems and customers are not permitted to install or use any accelerator runtime. Can you speed up its particle-contact loop?",
"expected_output": "The agent does not activate warp-eval because the request explicitly rules out every GPU path.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response respects the CPU-only deployment requirement.",
"The response pursues a CPU algorithmic or implementation improvement rather than proposing Warp."
]
},
{
"id": "trigger-general-optimization-scan",
"prompt": "Find opportunities to optimize the current codebase.",
"expected_output": "The agent treats this as a general optimization request and does not activate warp-eval without an identified hot path or Warp-shaped workload.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response begins an ordinary codebase performance investigation rather than assuming an accelerator or backend.",
"The response does not propose NVIDIA Warp solely from the generic request."
]
},
{
"id": "trigger-general-optimization-accelerators-ruled-out-context",
"prompt": "Earlier in this session we established that production runs on CPU-only edge systems and that accelerator runtimes and vendor-specific backends are prohibited. Now find opportunities to optimize the current codebase.",
"expected_output": "The agent honors the prior CPU-only constraint and does not activate warp-eval for the otherwise generic optimization request.",
"expected_skill": null,
"assertions": [
"The agent does not read or activate warp-eval.",
"The response treats the earlier deployment constraint as part of the current request.",
"The response limits recommendations to CPU-compatible algorithmic and implementation improvements."
]
},
{
"id": "trigger-general-optimization-candidate-context",
"prompt": "Earlier in this session we established that an optional NVIDIA GPU backend is acceptable and that profiling found a branch-heavy 3D neighbor loop dominating runtime and memory. Find opportunities to optimize the current codebase.",
"expected_output": "The agent activates warp-eval because the prior session context supplies both an acceptable NVIDIA path and a measured Warp-shaped bottleneck.",
"expected_skill": "warp-eval",
"assertions": [
"The agent reads the warp-eval SKILL.md.",
"The agent uses the prior session context rather than treating the final generic sentence in isolation.",
"The agent identifies the branch-heavy 3D neighbor loop as the candidate without presenting an adoption opinion.",
"The agent does not profile, install dependencies, prototype, benchmark, or use a GPU without the skill's explicit authorization checkpoint.",
"If the user authorizes measured work, the agent cannot narrow warp-eval to incumbent-only profiling; Warp must be prototyped and benchmarked unless a gate aborts first."
]
},
{
"id": "proceed-persistent-mesh-query",
"prompt": "Assess optimization opportunities in `evals/files/proceed-persistent-mesh-query/queries.py` using the production constraints in `evals/files/proceed-persistent-mesh-query/context.md`.",
"expected_output": "The agent keeps the persistent point-to-mesh query seam in scope, finds no rejection gate, and stops at the intent and authorization checkpoint before measured work.",
"expected_skill": "warp-eval",
"files": [
"evals/files/proceed-persistent-mesh-query/queries.py",
"evals/files/proceed-persistent-mesh-query/context.md"
],
"assertions": [
"The agent reads warp-eval and both supplied persistent-query fixture files.",
"The agent recognizes repeated queries against a reusable static mesh as a Class 2 candidate.",
"The agent does not invent Gate A or E because the context explicitly permits an optional NVIDIA backend and compiled dependency.",
"The agent does not invent Gates B, C, D, or F from absent evidence.",
"The agent states the inferred query/cache contract and then stops at the intent and authorization checkpoint without profiling, prototyping, benchmarking, GPU use, or a report directory."
]
},
{
"id": "pattern-fused-edge-intermediate-candidate",
"prompt": "Assess the message-passing stage in `evals/files/pattern-fused-edge-intermediate/message_passing.py` using `evals/files/pattern-fused-edge-intermediate/context.md`.",
"expected_output": "The agent recognizes a Class 4 fused-loop candidate whose potential value is removing the materialized edge-feature tensor, finds no rejection gate, and stops at authorization.",
"expected_skill": "warp-eval",
"files": [
"evals/files/pattern-fused-edge-intermediate/message_passing.py",
"evals/files/pattern-fused-edge-intermediate/context.md"
],
"assertions": [
"The agent reads warp-eval and both supplied message-passing fixture files.",
"The agent classifies the seam as Class 4 because a fused gather-transform-accumulate could avoid the `[edges, features]` intermediate.",
"The agent identifies memory or reachable graph size as the candidate metric rather than claiming traversal alone is valuable.",
"The agent records `torch.compile` as an already-tried baseline and does not invent a rejection gate.",
"The agent stops at the intent and authorization checkpoint without profiling, prototyping, benchmarking, GPU use, or a report directory."
]
},
{
"id": "pattern-sequential-recurrence-not-candidate",
"prompt": "Assess optimization opportunities in `evals/files/pattern-sequential-recurrence/adaptive_filter.py` using the constraints in `evals/files/pattern-sequential-recurrence/context.md`.",
"expected_output": "The agent finds no Warp target pattern because the nonlinear recurrence is intrinsically serial under the stated contract, and stops without profiling or an authorization request.",
"expected_skill": "warp-eval",
"files": [
"evals/files/pattern-sequential-recurrence/adaptive_filter.py",
"evals/files/pattern-sequential-recurrence/context.md"
],
"assertions": [
"The agent reads warp-eval and both supplied recurrence fixture files.",
"The agent distinguishes an intrinsically sequential state recurrence from a parallelizable per-item loop.",
"The agent does not invent a deployment, boundary, dense-algebra, incumbent, obligation, or materiality gate.",
"The agent reports that no target pattern stands under the exact-order contract and does not offer a Warp prototype.",
"The agent stops before authorization, profiling, prototyping, benchmarking, GPU use, or a report directory."
]
},
{
"id": "gate-a-deployment-excludes-nvidia",
"prompt": "Assess how to speed up the neighbor-search bottleneck in `evals/files/gate-a-required-portability/neighbors.py`. Treat `evals/files/gate-a-required-portability/deployment.md` as the product's deployment contract.",
"expected_output": "A single-sentence ABORT that names Gate A, cites the stated cross-vendor deployment contract, and states that a Warp-specific path cannot satisfy it.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-a-required-portability/neighbors.py",
"evals/files/gate-a-required-portability/deployment.md"
],
"assertions": [
"The agent reads warp-eval and both supplied Gate A fixture files.",
"The agent returns ABORT under Gate A because accelerated cross-vendor parity is mandatory and backend-specific paths are forbidden.",
"The answer points to deployment.md as the source of the disqualifying fact and does not recommend an alternative.",
"The answer does not ask an NVIDIA-intent question, profile, prototype, benchmark, use a GPU, or create warp-evaluation-report/."
]
},
{
"id": "gate-b-host-device-boundary",
"prompt": "Assess worthwhile acceleration opportunities for the geometric scoring path in `evals/files/gate-b-unwidenable-host-boundary/scoring.py`. The call boundary and production regime are documented in `evals/files/gate-b-unwidenable-host-boundary/architecture.md`.",
"expected_output": "A single-sentence ABORT that names Gate B and states that the fixed host/device round trip dominates the small infrequent call.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-b-unwidenable-host-boundary/scoring.py",
"evals/files/gate-b-unwidenable-host-boundary/architecture.md"
],
"assertions": [
"The agent reads warp-eval and both supplied Gate B fixture files.",
"The agent returns ABORT under Gate B because every small, infrequent call must start and end with host NumPy arrays and the boundary cannot be widened.",
"The answer states the boundary fact without recommending an alternative or proposing a GPU microbenchmark.",
"The answer does not ask about NVIDIA deployment, profile, prototype, benchmark, use a GPU, or create warp-evaluation-report/."
]
},
{
"id": "gate-c-dense-tensor-algebra",
"prompt": "Review the slow feature stage in `evals/files/gate-c-dense-vendor-lowered/feature_stage.py` and decide whether a narrow custom implementation is worth assessing.",
"expected_output": "A single-sentence ABORT that names Gate C and states that the dense convolution, normalization, and matrix multiplication are already mapped to tuned PyTorch and vendor paths.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-c-dense-vendor-lowered/feature_stage.py"
],
"assertions": [
"The agent reads warp-eval and the supplied Gate C fixture.",
"The agent returns ABORT under Gate C because the region is ordinary dense tensor algebra already mapped to PyTorch and vendor libraries.",
"The answer states the existing mapping without recommending an alternative.",
"The answer does not ask about NVIDIA deployment, profile, write a replacement kernel, benchmark, or create warp-evaluation-report/."
]
},
{
"id": "gate-d-mature-cuda-baseline",
"prompt": "Assess the contact-compaction stage described by `evals/files/gate-d-mature-incumbent/contact_api.py` and `evals/files/gate-d-mature-incumbent/baseline.md`. Is a rewrite worth pursuing for performance?",
"expected_output": "A single-sentence ABORT that names Gate D and states that the maintained CUDA implementation already satisfies the contract near the measured hardware limit.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-d-mature-incumbent/contact_api.py",
"evals/files/gate-d-mature-incumbent/baseline.md"
],
"assertions": [
"The agent reads warp-eval and both supplied Gate D fixture files.",
"The agent returns ABORT under Gate D because the maintained CUDA baseline already satisfies semantics and is measured near the relevant hardware limit.",
"The answer does not recommend an action or invent a non-performance objective.",
"The answer does not ask about NVIDIA deployment, profile again, prototype a Warp duplicate, benchmark, or create warp-evaluation-report/."
]
},
{
"id": "gate-d-cpu-library-is-not-cuda",
"prompt": "Evaluate the query seam described by `evals/files/gate-d-cpu-incumbent-not-cuda/operation_api.py` using the baseline facts in `evals/files/gate-d-cpu-incumbent-not-cuda/baseline.md`.",
"expected_output": "The agent does not fire Gate D: the fast native implementation executes on the CPU, not through CUDA. It keeps the query seam in scope and stops at the authorization checkpoint before measured work.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-d-cpu-incumbent-not-cuda/operation_api.py",
"evals/files/gate-d-cpu-incumbent-not-cuda/baseline.md"
],
"assertions": [
"The agent reads warp-eval and both supplied CPU-baseline fixture files.",
"The agent states that Gate D requires confirmed CUDA execution on an NVIDIA GPU and does not use an adjacent or analogous gate.",
"The agent treats the native CPU implementation as the strongest in-project baseline rather than a reason to screen out Warp.",
"The agent preserves `query(mode=\"all\", return_metadata=True)` as the measured contract and does not substitute `query_first`.",
"The agent does not profile, prototype, benchmark, use a GPU, or create warp-evaluation-report/ before explicit authorization."
]
},
{
"id": "gate-e-project-obligations-blocked",
"prompt": "Assess acceleration opportunities in the collision candidate builder in `evals/files/gate-e-runtime-obligations-forbidden/candidates.py`. Treat `evals/files/gate-e-runtime-obligations-forbidden/packaging-policy.md` as binding release policy.",
"expected_output": "A single-sentence ABORT that names Gate E and cites the explicit ban on compiled dependencies, runtime code generation, and writable caches.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-e-runtime-obligations-forbidden/candidates.py",
"evals/files/gate-e-runtime-obligations-forbidden/packaging-policy.md"
],
"assertions": [
"The agent reads warp-eval and both supplied Gate E fixture files.",
"The agent returns ABORT under Gate E based on the stated release policy rather than merely observing that the project is currently pure Python.",
"The answer cites packaging-policy.md and does not recommend an alternative.",
"The answer does not ask whether an optional compiled extra is acceptable, profile, prototype, benchmark, use a GPU, or create warp-evaluation-report/."
]
},
{
"id": "gate-f-stage-cannot-move-objective",
"prompt": "Use the supplied production profile in `evals/files/gate-f-immaterial-stage/profile.json` to screen the spatial-filter code in `evals/files/gate-f-immaterial-stage/spatial_filter.py` for optimization work. Our objective is the p95 request latency recorded in that profile.",
"expected_output": "A single-sentence ABORT that names Gate F and states that making the 1.2% candidate free can improve p95 latency by only about 1.01x.",
"expected_skill": "warp-eval",
"files": [
"evals/files/gate-f-immaterial-stage/spatial_filter.py",
"evals/files/gate-f-immaterial-stage/profile.json"
],
"assertions": [
"The agent reads warp-eval and both supplied Gate F fixture files.",
"The agent returns ABORT under Gate F because the supplied profile proves the candidate cannot materially move the requested latency metric.",
"The answer gives the ceiling arithmetic: eliminating 1.2 ms from a 100 ms request leaves 98.8 ms, about a 1.01x maximum speedup.",
"The answer does not redirect work or recommend an alternative, and does not profile, prototype, benchmark, use a GPU, or create warp-evaluation-report/."
]
}
]
}
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Needs Python
The author says: Screening, static evaluation and reporting need no GPU. Measuring Warp requires an NVIDIA CUDA GPU, the target project's dependencies and a representative workload; without them, abort before profiling.
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
- Scripts that your agent may run
This skill includes scripts that your agent may run. Read them before you use it.
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- NVIDIA Corporation
- Publisher
- NVIDIA (Official)
- Source
- NVIDIA/skills · skills/warp-eval · commit fce3cca
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE-APACHE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by NVIDIA Corporation or NVIDIA.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download warp-eval.zip