oz-upload-file — Claude Code skill: file upload
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.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill oz-upload-file -a claude-codeWhat oz-upload-file 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.
What it helps with
- attach a screenshot to an Oz task
- share a log without committing it
- upload a generated report as a task artifact
Example prompts for the agent
- Attach
/tmp/login.pngto the Oz task and describe it as a screenshot of the sign-in error. - Upload
/tmp/build.logas an artifact for this Oz task. - Add the existing file
/tmp/report.htmlto the Oz conversation.
How to install oz-upload-file
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-upload-file -a claude-code2Manually: put the files in place
~/.claude/skills/oz-upload-file/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/oz-upload-file/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-upload-file -a codex2Manually: put the files in place
.agents/skills/oz-upload-file/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-upload-file -a cursor2Manually: put the files in place
.cursor/skills/oz-upload-file/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/harness_skills/oz-upload-file2Manually: put the files in place
.github/skills/oz-upload-file/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill oz-upload-file -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/harness_skills/oz-upload-fileManually: put the files in place
.devin/skills/oz-upload-file/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about oz-upload-file
How do I install oz-upload-file in Claude Code?
Run npx skills add dominikmartn/harp --skill oz-upload-file -a claude-code. The skill file is at ~/.claude/skills/oz-upload-file/SKILL.md.
What does oz-upload-file do?
It uploads an existing local file to Oz and attaches it to a conversation as an artifact. The file is kept out of commits and pull requests.
What does oz-upload-file need to run?
It needs OZ_CLI, OZ_RUN_ID, and access to Oz. The file must already be on disk, and the command takes its absolute path.