How do I install the Knbox skill?

Run npx skillmds@latest add summic/knbox in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Knbox safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Knbox?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Knbox free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

summic (@summic) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Knbox by summic — Agent Skill

Name: Knbox
Author: summic

File contents

KN Box Skill

Use KN Box when you need to upload files for preview or sharing.

Requirements

Use the knbox CLI as the only upload mechanism.
Prefer non-interactive auth with KNBOX_TOKEN when available.
Default server is https://box.kn.run.
Do not upload sensitive information.

Verify Access

Before uploading, verify the CLI can reach KN Box:

knbox auth whoami --json

If this fails because the user is not logged in, ask the user to run:

knbox auth login

In a non-interactive environment, ask the user for a KN Box CLI token and set:

export KNBOX_TOKEN=knbox_xxx

The default server is already https://box.kn.run. Set KNBOX_URL only when the user explicitly wants a different KN Box server.

Upload Files

Upload a file or directory:

knbox upload <file-or-dir> --json

Upload into a specific remote directory:

knbox upload <file-or-dir> --to /agent-output --json

Read the returned JSON:

data.entryUrl is the best URL to show for a webpage directory.
data.uploaded[].url contains individual file URLs.
summary is a short human-readable result.
breadcrumbs contains useful follow-up commands.

Navigation

List files:

knbox ls [path] --json

Change the saved remote directory:

knbox cd <path>

Open a file or directory:

knbox open <path> --json

For a file, open returns the public URL. For a directory, it returns a directory listing.

Conflict Handling

Uploads fail on conflicts by default.

Use --rename only when creating a distinct copy is acceptable:

knbox upload <path> --rename --json

Use --overwrite only when the user explicitly wants to replace existing files:

knbox upload <path> --overwrite --json

Failure Handling

If knbox exits non-zero, read stderr and report the failure. Do not assume the file was uploaded.

---name: knboxdescription: Upload webpages, Markdown files, and images to KN Box through the `knbox` CLI and return public preview URLs. Use when an agent needs to publish generated files for preview or sharing.---# KN Box SkillUse KN Box when you need to upload files for preview or sharing.## Requirements- Use the `knbox` CLI as the only upload mechanism.- Prefer non-interactive auth with `KNBOX_TOKEN` when available.- Default server is `https://box.kn.run`.- Do not upload sensitive information.## Verify AccessBefore uploading, verify the CLI can reach KN Box:```bashknbox auth whoami --json```If this fails because the user is not logged in, ask the user to run:```bashknbox auth login```In a non-interactive environment, ask the user for a KN Box CLI token and set:```bashexport KNBOX_TOKEN=knbox_xxx```The default server is already `https://box.kn.run`. Set `KNBOX_URL` only when the user explicitly wants a different KN Box server.## Upload FilesUpload a file or directory:```bashknbox upload <file-or-dir> --json```Upload into a specific remote directory:```bashknbox upload <file-or-dir> --to /agent-output --json```Read the returned JSON:- `data.entryUrl` is the best URL to show for a webpage directory.- `data.uploaded[].url` contains individual file URLs.- `summary` is a short human-readable result.- `breadcrumbs` contains useful follow-up commands.## NavigationList files:```bashknbox ls [path] --json```Change the saved remote directory:```bashknbox cd <path>```Open a file or directory:```bashknbox open <path> --json```For a file, `open` returns the public URL. For a directory, it returns a directory listing.## Conflict HandlingUploads fail on conflicts by default.Use `--rename` only when creating a distinct copy is acceptable:```bashknbox upload <path> --rename --json```Use `--overwrite` only when the user explicitly wants to replace existing files:```bashknbox upload <path> --overwrite --json```## Failure HandlingIf `knbox` exits non-zero, read stderr and report the failure. Do not assume the file was uploaded.

Frequently asked questions

Knbox