PrivateBin Upload Skill

When to Use

Use this skill when:

• User wants to upload/share text, code, reports, or files via a paste link
• User mentions "paste", "privatebin", "shareable link", "burn after reading", or "password-protect"
• User needs expiry-controlled or one-time viewing sharing

Do NOT use this skill when:

• User only wants to read an existing paste (use privatebin show directly)
• No content or file has been identified to upload
• User is asking about PrivateBin in general without intent to upload

Input / Output

Input:
  content:    string | file_path   # text/code to upload, or file path
  formatter?: plaintext | markdown | syntaxhighlighting  # default: plaintext
  expire?:    5min | 10min | 1hour | 1day | 1week | 1month | 1year | never
  burn_after_reading?: boolean     # default: false
  password?:  string               # ask user if requested
  attachment?: boolean             # true for binary/image/archive files
  bin?:       string               # named instance from config

Output:
  paste_url:  string   # shareable link to present
  expire:     string   # expiry setting used
  password?:  string   # echoed back if set

Steps

1. Check CLI — Run privatebin --version. If not found, install privatebin-cli and stop until user resolves it.

1. Check config — Verify ~/.config/privatebin/config.json exists. If missing, run:

```bash

privatebin init # default: privatebin.net

privatebin init --host https://bin.example.com # custom host

```

1. Determine parameters — Infer formatter, expiry, attachment from context. Use defaults (plaintext, 1day) if unspecified. Ask for password only if user requested it.

1. Run upload — Use --output=json as global flag (before create):

```bash

# Text/code via stdin

printf '%s' "" | privatebin --output=json create [flags]

# From file

privatebin --output=json create --filename=/path/to/file [flags]

# File attachment

privatebin --output=json create --attachment --filename=/path/to/file [flags]

```

1. Parse response — Extract paste_url from JSON:

```json

{ "paste_id": "...", "paste_url": "https://bin.example.com?id#key", "delete_token": "..." }

```

1. Confirm — Present paste_url, expiry, and password (if set) to user.

Common Flags

On Failure