{ "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": { "downloadMode": "redirect", "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", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "_meta.json", "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/picsee-url-shortener-web", "agentPageUrl": "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" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "PicSee URL Shortener", "body": "Quickly shorten long URLs and generate QR codes via PicSee (picsee.io). After logging in, you can also access analytics and history records." }, { "title": "Important Rules", "body": "Always use profile: \"openclaw\"\nEach snapshot generates new refs - don't reuse old refs\nIf any step fails, restart from Step 1\nWhen reading files, only use file_path parameter - don't pass path: \"\" (empty string causes EISDIR errors)\nQR code is opt-in - Don't generate QR code unless user explicitly asks for it (saves tokens)\nUse virtual environment for QR generation - Ensures qrcode package is always available without polluting system Python" }, { "title": "Workflow", "body": "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)." }, { "title": "Step 1: Open PicSee with URL", "body": "URL-encode the long URL, then append it to https://picsee.io/?url=.\n\nUse browser tool:\n\naction: \"open\"\nprofile: \"openclaw\"\ntargetUrl: \"https://picsee.io/?url=(URL-encoded long URL)\"\n\nURL encoding example:\n\nOriginal: https://example.com/path?a=1&b=2\nEncoded: https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2\nFull: https://picsee.io/?url=https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2\n\nSave the returned targetId - you'll need it for following steps." }, { "title": "Step 2: Wait for shortening to complete", "body": "Use browser tool to wait 3 seconds:\n\naction: \"act\"\nprofile: \"openclaw\"\ntargetId: \"(targetId from Step 1)\"\nrequest:\n kind: \"wait\"\n timeMs: 3000" }, { "title": "Step 3: Extract shortened URL", "body": "Take a snapshot and extract the shortened URL from the page content:\n\naction: \"snapshot\"\nprofile: \"openclaw\"\ntargetId: \"(targetId from Step 1)\"\nrefs: \"aria\"\n\nRead the snapshot text and identify the shortened URL. PicSee displays the result prominently on the page after shortening completes. Look for:\n\nA clickable link that looks like a short URL\nText that says \"shortened URL\" or similar followed by a link\nAny URL that's clearly shorter than the original input\n\nIf 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)." }, { "title": "Step 4: Reply with short URL and ask about QR code", "body": "Reply with the shortened URL only. Do NOT generate QR code by default.\n\nReply in the same language as the user's original request. Example format in English:\n\nShort URL: https://pse.is/xxxxx\n\nNeed QR code?\n\nThe language model will automatically translate this to the user's language if needed.\n\nWait for user response. If user confirms they want QR code, proceed to Step 5." }, { "title": "Step 5 (Optional): Generate QR code with virtual environment", "body": "Only run this step if user explicitly requests QR code.\n\nUse Python virtual environment to ensure qrcode package is available:\n\n# Check if venv exists, create if not\nif [ ! -d ~/openclaw_python_venv ]; then\n python3 -m venv ~/openclaw_python_venv\n source ~/openclaw_python_venv/bin/activate\n pip install qrcode pillow\nelse\n source ~/openclaw_python_venv/bin/activate\nfi\n\n# Generate QR code\npython3 - <<'PY'\nimport qrcode\nqr = qrcode.QRCode()\nqr.add_data(\"THE_SHORT_URL_HERE\")\nqr.make(fit=True)\nimg = qr.make_image(fill_color=\"black\", back_color=\"white\")\nimg.save(\"/tmp/picsee_qr.png\")\nprint(\"QR code saved\")\nPY\n\nAfter generation, send the QR code image file using message tool with filePath: \"/tmp/picsee_qr.png\"." }, { "title": "Fallback Method (when quick method fails)", "body": "If Step 1's URL parameter method doesn't auto-shorten (page stays on homepage), use manual operation:\n\nsnapshot to get page element refs (refs: \"aria\")\nFind the input box (textbox named \"網址貼這裡\") and button (img \"PicSee!\")\nact type to enter the URL in the input box\nact click to click the shorten button\nReturn to Steps 2-4 to extract results" }, { "title": "Common Error Handling", "body": "EISDIR error: When reading files, don't pass path: \"\", only use file_path parameter\nUnknown ref: Ref has expired, re-run snapshot to get new refs\ntab not found: Page was closed, restart from Step 1\nShort URL not visible in snapshot: Increase wait time to 5000ms and retry\nStill can't find short URL: Switch to fallback method\nvenv creation fails: Check Python version with python3 --version (need 3.3+)" } ], "body": "PicSee URL Shortener\n\nQuickly shorten long URLs and generate QR codes via PicSee (picsee.io). After logging in, you can also access analytics and history records.\n\nImportant Rules\nAlways use profile: \"openclaw\"\nEach snapshot generates new refs - don't reuse old refs\nIf any step fails, restart from Step 1\nWhen reading files, only use file_path parameter - don't pass path: \"\" (empty string causes EISDIR errors)\nQR code is opt-in - Don't generate QR code unless user explicitly asks for it (saves tokens)\nUse virtual environment for QR generation - Ensures qrcode package is always available without polluting system Python\nWorkflow\n\nCore 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).\n\nStep 1: Open PicSee with URL\n\nURL-encode the long URL, then append it to https://picsee.io/?url=.\n\nUse browser tool:\n\naction: \"open\"\nprofile: \"openclaw\"\ntargetUrl: \"https://picsee.io/?url=(URL-encoded long URL)\"\n\n\nURL encoding example:\n\nOriginal: https://example.com/path?a=1&b=2\nEncoded: https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2\nFull: https://picsee.io/?url=https%3A%2F%2Fexample.com%2Fpath%3Fa%3D1%26b%3D2\n\nSave the returned targetId - you'll need it for following steps.\n\nStep 2: Wait for shortening to complete\n\nUse browser tool to wait 3 seconds:\n\naction: \"act\"\nprofile: \"openclaw\"\ntargetId: \"(targetId from Step 1)\"\nrequest:\n kind: \"wait\"\n timeMs: 3000\n\nStep 3: Extract shortened URL\n\nTake a snapshot and extract the shortened URL from the page content:\n\naction: \"snapshot\"\nprofile: \"openclaw\"\ntargetId: \"(targetId from Step 1)\"\nrefs: \"aria\"\n\n\nRead the snapshot text and identify the shortened URL. PicSee displays the result prominently on the page after shortening completes. Look for:\n\nA clickable link that looks like a short URL\nText that says \"shortened URL\" or similar followed by a link\nAny URL that's clearly shorter than the original input\n\nIf 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).\n\nStep 4: Reply with short URL and ask about QR code\n\nReply with the shortened URL only. Do NOT generate QR code by default.\n\nReply in the same language as the user's original request. Example format in English:\n\nShort URL: https://pse.is/xxxxx\n\nNeed QR code?\n\n\nThe language model will automatically translate this to the user's language if needed.\n\nWait for user response. If user confirms they want QR code, proceed to Step 5.\n\nStep 5 (Optional): Generate QR code with virtual environment\n\nOnly run this step if user explicitly requests QR code.\n\nUse Python virtual environment to ensure qrcode package is available:\n\n# Check if venv exists, create if not\nif [ ! -d ~/openclaw_python_venv ]; then\n python3 -m venv ~/openclaw_python_venv\n source ~/openclaw_python_venv/bin/activate\n pip install qrcode pillow\nelse\n source ~/openclaw_python_venv/bin/activate\nfi\n\n# Generate QR code\npython3 - <<'PY'\nimport qrcode\nqr = qrcode.QRCode()\nqr.add_data(\"THE_SHORT_URL_HERE\")\nqr.make(fit=True)\nimg = qr.make_image(fill_color=\"black\", back_color=\"white\")\nimg.save(\"/tmp/picsee_qr.png\")\nprint(\"QR code saved\")\nPY\n\n\nAfter generation, send the QR code image file using message tool with filePath: \"/tmp/picsee_qr.png\".\n\nFallback Method (when quick method fails)\n\nIf Step 1's URL parameter method doesn't auto-shorten (page stays on homepage), use manual operation:\n\nsnapshot to get page element refs (refs: \"aria\")\nFind the input box (textbox named \"網址貼這裡\") and button (img \"PicSee!\")\nact type to enter the URL in the input box\nact click to click the shorten button\nReturn to Steps 2-4 to extract results\nCommon Error Handling\nEISDIR error: When reading files, don't pass path: \"\", only use file_path parameter\nUnknown ref: Ref has expired, re-run snapshot to get new refs\ntab not found: Page was closed, restart from Step 1\nShort URL not visible in snapshot: Increase wait time to 5000ms and retry\nStill can't find short URL: Switch to fallback method\nvenv creation fails: Check Python version with python3 --version (need 3.3+)" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/PicSeeInc/picsee-url-shortener-web", "publisherUrl": "https://clawhub.ai/PicSeeInc/picsee-url-shortener-web", "owner": "PicSeeInc", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "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" } }