# oz-upload-file

oz-upload-file is a Claude Code skill that sends a local file to Oz as a conversation artifact. It handles task attachments that should stay out of commits and pull requests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/harness_skills/oz-upload-file/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/oz-upload-file

## What it does

oz-upload-file uploads a file that already exists on disk and attaches it to an Oz task. Common artifacts include screenshots, logs, and generated reports that do not belong in the repository.

The skill runs `"$OZ_CLI" artifact upload '<path>' --run-id "$OZ_RUN_ID" --description '<description>'`. Supply an absolute file path; the description can be left out when the filename explains the attachment. The command needs `OZ_CLI`, `OZ_RUN_ID`, and access to Oz. Source code, tests, and docs should go through a commit and pull request instead.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-upload-file -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-upload-file -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/oz-upload-file/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-upload-file -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/oz-upload-file/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/harness_skills/oz-upload-file
```

2. **Manually: put the files in place**
- File: `.github/skills/oz-upload-file/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill oz-upload-file -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/harness_skills/oz-upload-file
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/oz-upload-file/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/dominikmartn/harp/tree/HEAD/resources/bundled/harness_skills/oz-upload-file/SKILL.md

## When to use it
- attach a screenshot to an Oz task
- share a log without committing it
- upload a generated report as a task artifact

## Example prompts
- Attach `/tmp/login.png` to the Oz task and describe it as a screenshot of the sign-in error.
- Upload `/tmp/build.log` as an artifact for this Oz task.
- Add the existing file `/tmp/report.html` to the Oz conversation.

## Similar
- [experience-ui-bundle-file-upload-generate](https://affpapa.org/en/nevibecode/skills/experience-ui-bundle-file-upload-generate.md) — skill · 5200 installs
- [hunt-file-upload](https://affpapa.org/en/nevibecode/skills/hunt-file-upload.md) — skill · ★ 16193 repo stars
- [file-upload-and-webshell](https://affpapa.org/en/nevibecode/skills/file-upload-and-webshell.md) — skill · ★ 73 repo stars
- [Notion Large File Upload](https://affpapa.org/en/nevibecode/mcp/notion-large-file-upload.md) — MCP server · ★ 13 repo stars
- [gws-drive-upload](https://affpapa.org/en/nevibecode/skills/gws-drive-upload.md) — skill · 51400 installs
- [huawei-cloud-obs-upload](https://affpapa.org/en/nevibecode/skills/huawei-cloud-obs-upload.md) — skill · 18400 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 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
