# Warp debug gradients

> Warp debug gradients is an open-source agent skill. Use to diagnose and fix incorrect gradients in differentiable Warp programs. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/NVIDIA/skills/tree/main/skills/warp-debug-gradients
- **Repository:** https://github.com/nvidia/skills
- **GitHub stars:** 4,037
- **License:** Apache-2.0
- **Skill name:** warp-debug-gradients
- **Collection:** https://github.com/NVIDIA/skills
- **Listing updated:** 2026-11-17

## About

Use to diagnose and fix incorrect gradients in differentiable Warp programs. Anything trained, optimized, calibrated, or fit through Warp kernels depends on wp.Tape gradients, so treat any misbehavior of such a workflow as a gradient problem until proven otherwise — use this when training diverges or NaNs, won't train at all, stalls or plateaus above the expected loss, converges to a wrong or biased answer, is worse than a reference implementation, works at small scale but fails at production scale, or fails a QA/validation recheck. Also for explicit symptoms — exploding, NaN/inf, zero, or subtly wrong gradients, suspected wp.Tape/backward issues, gradcheck failures — but users usually describe only the surface symptom ("the sim explodes", "the fit gets dragged toward outliers") without mentioning gradients: make that leap. Not for forward-only Warp work, build/install problems, or autograd issues in other frameworks without Warp.

## When your agent uses it

> Use to diagnose and fix incorrect gradients in differentiable Warp programs. Anything trained, optimized, calibrated, or fit through Warp kernels depends on wp.Tape gradients, so treat any misbehavior of such a workflow as a gradient problem until proven otherwise — use this when training diverges or NaNs, won't train at all, stalls or plateaus above the expected loss, converges to a wrong or biased answer, is worse than a reference implementation, works at small scale but fails at production scale, or fails a QA/validation recheck. Also for explicit symptoms — exploding, NaN/inf, zero, or subtly wrong gradients, suspected wp.Tape/backward issues, gradcheck failures — but users usually describe only the surface symptom ("the sim explodes", "the fit gets dragged toward outliers") without mentioning gradients: make that leap. Not for forward-only Warp work, build/install problems, or autograd issues in other frameworks without Warp.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs Python scripts](https://github.com/NVIDIA/skills/tree/HEAD/skills/warp-debug-gradients)
- [No network calls found in its scripts](https://github.com/NVIDIA/skills/tree/HEAD/skills/warp-debug-gradients)
- [License: Apache-2.0](https://github.com/NVIDIA/skills/tree/HEAD/skills/warp-debug-gradients)

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/warp-debug-gradients` to use it in all your projects:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/warp-debug-gradients &&
cp -R "$tmp/skills/warp-debug-gradients" ~/.claude/skills/warp-debug-gradients &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/warp-debug-gradients` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/warp-debug-gradients` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/warp-debug-gradients &&
cp -R "$tmp/skills/warp-debug-gradients" ~/.agents/skills/warp-debug-gradients &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/warp-debug-gradients` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/warp-debug-gradients` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/warp-debug-gradients &&
cp -R "$tmp/skills/warp-debug-gradients" ~/.cursor/skills/warp-debug-gradients &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/warp-debug-gradients` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/NVIDIA/skills.git --path skills/warp-debug-gradients
```

Or copy the folder to `~/.gemini/skills/warp-debug-gradients` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/warp-debug-gradients`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/NVIDIA/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/warp-debug-gradients &&
cp -R "$tmp/skills/warp-debug-gradients" ~/.copilot/skills/warp-debug-gradients &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/warp-debug-gradients` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/NVIDIA/skills.git
```

Then copy `skills/skills/warp-debug-gradients` into your agent's skills folder as `warp-debug-gradients`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Warp debug gradients in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/warp-debug-gradients to use it in all your projects, or to .claude/skills/warp-debug-gradients in one project.

### Does Warp debug gradients run scripts?

Yes. It runs Python scripts. No network calls were found in its scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Warp debug gradients?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

---
Source: https://ai-powered.com/skills/warp-debug-gradients
