# doca-structured-tools-contract

The doca-structured-tools-contract skill guides an agent through gathering DOCA environment and device details with a structured helper or manual commands. It also covers pre-commit validation and host-versus-DPU checks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 4106 repo stars
- Author: NVIDIA
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-structured-tools-contract/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/doca-structured-tools-contract

## What it does

The skill defines a decision path for DOCA questions. The agent checks whether the relevant structured helper is available and validates its JSON against the selected schema. If that path fails, it follows the matching manual command sequence and tells the user which route it used.

Its scope covers versions, devices, library capabilities, specification checks before commit, and host/DPU state comparisons. Running probes and fallback commands requires access to the target host; validation steps need a working DOCA installation at `/opt/mellanox/doca`. This skill does not cover library implementation or a fresh DOCA setup.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-structured-tools-contract -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/doca-structured-tools-contract/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/doca-structured-tools-contract/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-structured-tools-contract -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/doca-structured-tools-contract/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-structured-tools-contract -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/doca-structured-tools-contract/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skills/doca-structured-tools-contract
```

2. **Manually: put the files in place**
- File: `.github/skills/doca-structured-tools-contract/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill doca-structured-tools-contract -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/doca-structured-tools-contract
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/doca-structured-tools-contract/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NVIDIA/skills/tree/HEAD/skills/doca-structured-tools-contract/SKILL.md

## When to use it
- Gather DOCA version and environment details
- List devices and their capabilities
- Check a specification before commit
- Compare DOCA state on host and DPU

## Example prompts
- Summarize my DOCA installation, including its version, devices, and available capabilities.
- Check whether this specification passes validation before I commit it.
- Compare the DOCA state on the host with the DPU.

## Similar
- [contract-testing](https://affpapa.org/en/nevibecode/skills/contract-testing.md) — skill · 1400 installs
- [structured-logging-standardizer](https://affpapa.org/en/nevibecode/skills/structured-logging-standardizer.md) — skill · 273 installs
- [suede-parity-contract](https://affpapa.org/en/nevibecode/skills/suede-parity-contract.md) — skill · ★ 121 repo stars
- [nemo-evaluator-sdk](https://affpapa.org/en/nevibecode/skills/nemo-evaluator-sdk.md) — skill · 1100 installs
- [api-contract-testing](https://affpapa.org/en/nevibecode/skills/api-contract-testing.md) — skill · 934 installs
- [planetscale-change-gates-and-approval-contract](https://affpapa.org/en/nevibecode/skills/planetscale-change-gates-and-approval-contract.md) — skill · 1900 installs

From the same set: [nvidia/skills](https://affpapa.org/en/nevibecode/by/nvidia/skills.md) — 312 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
