skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
summic/knbox-skills51 installs

knbox

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.

How do I install this agent skill?

npx skills add https://github.com/summic/knbox-skills --skill knbox
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The knbox skill allows an agent to upload files, images, and folders to the KN Box hosting service using a dedicated command-line interface. It manages authentication, directory navigation, and file transfers to provide public preview URLs for shared content.

  • Socketwarn

    1 alert: gptSecurity

  • Snykfail

    Risk: HIGH · 1 issue

What does this agent skill do?

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.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/summic/knbox-skills/knbox">View knbox on skillZs</a>