# Send PicSee URL Shortener & QR Codes (Web) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "picsee-url-shortener-web",
    "name": "PicSee URL Shortener & QR Codes (Web)",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/PicSeeInc/picsee-url-shortener-web",
    "canonicalUrl": "https://clawhub.ai/PicSeeInc/picsee-url-shortener-web",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/picsee-url-shortener-web",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=picsee-url-shortener-web",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "_meta.json",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/picsee-url-shortener-web"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/picsee-url-shortener-web",
    "downloadUrl": "https://openagent3.xyz/downloads/picsee-url-shortener-web",
    "agentUrl": "https://openagent3.xyz/skills/picsee-url-shortener-web/agent",
    "manifestUrl": "https://openagent3.xyz/skills/picsee-url-shortener-web/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/picsee-url-shortener-web/agent.md"
  }
}
```
## Documentation

### PicSee URL Shortener

Quickly shorten long URLs and generate QR codes via PicSee (picsee.io). After logging in, you can also access analytics and history records.

### Important Rules

Always use profile: "openclaw"
Each snapshot generates new refs - don't reuse old refs
If any step fails, restart from Step 1
When reading files, only use file_path parameter - don't pass path: "" (empty string causes EISDIR errors)
QR code is opt-in - Don't generate QR code unless user explicitly asks for it (saves tokens)
Use virtual environment for QR generation - Ensures qrcode package is always available without polluting system Python

### Workflow

Core technique: URL-encode the link and append it to the query string, PicSee will auto-shorten it. Only generate QR code if user requests it (to save tokens).

### Step 1: Open PicSee with URL

URL-encode the long URL, then append it to https://picsee.io/?url=.

Use browser tool:

action: "open"
profile: "openclaw"
targetUrl: "https://picsee.io/?url=(URL-encoded long URL)"

URL encoding example:

Original: https://example.com/path?a=1&b=2
Encoded: https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2
Full: https://picsee.io/?url=https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2

Save the returned targetId - you'll need it for following steps.

### Step 2: Wait for shortening to complete

Use browser tool to wait 3 seconds:

action: "act"
profile: "openclaw"
targetId: "(targetId from Step 1)"
request:
  kind: "wait"
  timeMs: 3000

### Step 3: Extract shortened URL

Take a snapshot and extract the shortened URL from the page content:

action: "snapshot"
profile: "openclaw"
targetId: "(targetId from Step 1)"
refs: "aria"

Read the snapshot text and identify the shortened URL. PicSee displays the result prominently on the page after shortening completes. Look for:

A clickable link that looks like a short URL
Text that says "shortened URL" or similar followed by a link
Any URL that's clearly shorter than the original input

If you can't find the short URL in the snapshot, wait another 3 seconds and retry. If still not found after 2 retries, use the fallback method (see below).

### Step 4: Reply with short URL and ask about QR code

Reply with the shortened URL only. Do NOT generate QR code by default.

Reply in the same language as the user's original request. Example format in English:

Short URL: https://pse.is/xxxxx

Need QR code?

The language model will automatically translate this to the user's language if needed.

Wait for user response. If user confirms they want QR code, proceed to Step 5.

### Step 5 (Optional): Generate QR code with virtual environment

Only run this step if user explicitly requests QR code.

Use Python virtual environment to ensure qrcode package is available:

# Check if venv exists, create if not
if [ ! -d ~/openclaw_python_venv ]; then
  python3 -m venv ~/openclaw_python_venv
  source ~/openclaw_python_venv/bin/activate
  pip install qrcode pillow
else
  source ~/openclaw_python_venv/bin/activate
fi

# Generate QR code
python3 - <<'PY'
import qrcode
qr = qrcode.QRCode()
qr.add_data("THE_SHORT_URL_HERE")
qr.make(fit=True)
img = qr.make_image(fill_color="black", back_color="white")
img.save("/tmp/picsee_qr.png")
print("QR code saved")
PY

After generation, send the QR code image file using message tool with filePath: "/tmp/picsee_qr.png".

### Fallback Method (when quick method fails)

If Step 1's URL parameter method doesn't auto-shorten (page stays on homepage), use manual operation:

snapshot to get page element refs (refs: "aria")
Find the input box (textbox named "網址貼這裡") and button (img "PicSee!")
act type to enter the URL in the input box
act click to click the shorten button
Return to Steps 2-4 to extract results

### Common Error Handling

EISDIR error: When reading files, don't pass path: "", only use file_path parameter
Unknown ref: Ref has expired, re-run snapshot to get new refs
tab not found: Page was closed, restart from Step 1
Short URL not visible in snapshot: Increase wait time to 5000ms and retry
Still can't find short URL: Switch to fallback method
venv creation fails: Check Python version with python3 --version (need 3.3+)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: PicSeeInc
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/picsee-url-shortener-web)
- [Send to Agent page](https://openagent3.xyz/skills/picsee-url-shortener-web/agent)
- [JSON manifest](https://openagent3.xyz/skills/picsee-url-shortener-web/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/picsee-url-shortener-web/agent.md)
- [Download page](https://openagent3.xyz/downloads/picsee-url-shortener-web)