openclawclaude-codev1.0.0

picsee-short-link

@PicSeeInc⭐ 0 stars· last commit 7mo ago· 0 open issues

PicSee URL shortener with QR code generation, analytics charts, and link management via CLI. Use when the user asks to shorten a URL, generate QR codes, visualize analytics, list/search links, or mentions PicSee. Supports unauthenticated mode (basic shortening + QR codes + charts) and authenticated

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/content/picsee-short-link. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

7.8/10

Verified

Mar 8, 2026

// RATINGS

⭐GitHub Stars

⭐ 0 on GitHubGitHub ↗

New / niche

🟢ProSkills ScoreAI Verified

7.8/10

📍

Not yet listed on ClawHub or SkillsMP

// README

🔗 Skill for PicSee URL Shortener

A CLI-based Agent Skill for PicSee — URL shortening with QR code generation, click analytics, and link management.

Works with any AI agent that supports the Agent Skills standard or can run shell commands.

🌟 Features

Dual-Mode Operation — Unauthenticated (basic shortening) and Authenticated (full management) with automatic detection
URL Shortening + QR Codes — Create short links and instantly generate QR codes (300x300px, customizable)
Visual Analytics — Total clicks, unique clicks, daily trends, and chart generation
Secure Token Storage — AES-256-CBC encryption with salted key derivation (random 32-byte salt + hostname + username → SHA-256). Tokens never stored in plaintext
Link Management — Search, filter (tags, stars, keywords), edit, and delete
Minimal Dependencies — Requires only Node.js >= 18 (uses built-in modules, no extra npm packages at runtime)
Agent Skills Standard — Compatible with 25+ AI agents and development tools

⚙️ Installation

Claude Code

cp -r picsee-short-link ~/.claude/skills/picsee-short-link

Then invoke with /picsee-short-link or let Claude auto-discover it.

ClawHub

clawhub install picsee-short-link

Or browse: https://clawhub.ai/PicSeeInc/picsee-short-link

Smithery

Install via Smithery registry:

npx @smithery/cli install picsee/short-link

Or browse: https://smithery.ai/skills/picsee/short-link

claude.ai

Upload the skill folder in Customize → Skills. Claude will auto-invoke it when relevant.

Cursor

Place the skill folder in .cursor/skills/:

cp -r picsee-short-link .cursor/skills/picsee-short-link

OpenAI Codex

Place the skill folder in .codex/skills/:

cp -r picsee-short-link .codex/skills/picsee-short-link

Direct CLI

Any agent with shell access can call the CLI directly:

node /path/to/picsee-short-link/cli/dist/cli.js shorten "https://example.com"
node /path/to/picsee-short-link/cli/dist/cli.js shorten "https://example.com" --slug mylink --tags seo,marketing
node /path/to/picsee-short-link/cli/dist/cli.js list --limit 10
node /path/to/picsee-short-link/cli/dist/cli.js help

🤖 Supported Platforms

This skill follows the Agent Skills open standard, which is supported by:

Platform	How to install	How it works
Claude Code	`cp -r picsee-short-link ~/.claude/skills/`	Auto-discovered, invoke with `/picsee-short-link`
claude.ai	Upload skill folder in Customize → Skills	Auto-invoked when relevant
OpenClaw	`clawhub install picsee-short-link`	Auto-discovered via SKILL.md
Cursor	Place in `.cursor/skills/`	Auto-discovered by agent
VS Code Copilot	Place in `.github/skills/`	Auto-discovered by Copilot
OpenAI Codex	Place in `.codex/skills/`	Auto-discovered
Gemini CLI	Place in `.gemini/skills/`	Auto-discovered
Any shell agent	Point to CLI path	`node cli/dist/cli.js shorten "..."`

See agentskills.io for the full list of supported platforms.

🧩 Commands

Command	Description	Auth
`shorten <url>`	Create a `pse.is` short link with optional custom slug, tags, UTM, and preview metadata	Optional
`analytics <id>`	Click statistics — total, unique, and daily breakdown	Required
`chart <id>`	Fetch analytics and generate a chart URL visualizing daily click trends	Required
`list`	List and search link history with filters (tags, keywords, stars, date range)	Required
`edit <id>`	Update destination URL, slug, title, description, tags, expiration (Advanced plan)	Required
`delete <id>`	Delete a short link	Required
`recover <id>`	Recover a deleted short link	Required
`qr <shortUrl>`	Generate a QR code URL for any short link	No
`auth <token>`	Verify and encrypt your PicSee API token locally	No
`auth-status`	Check current authentication status	No

🔑 Authentication

# Store your PicSee API token (encrypted locally)
node /path/to/picsee-short-link/cli/dist/cli.js auth <token>

# Check auth status
node /path/to/picsee-short-link/cli/dist/cli.js auth-status

Get your token: picsee.io → Avatar → Settings → API → Copy token.

🔒 Security

Aspect	Detail
Storage	`~/.openclaw/.picsee_token` (encrypted token) + `~/.openclaw/.picsee_salt` (random salt)
Encryption	AES-256-CBC, random IV per write
Key Derivation	`SHA-256(random-32byte-salt + hostname + "-" + username)` — salt generated once, making key unpredictable even if hostname/username are known
File Permissions	`0600` on both token and salt files (owner read/write only)

📁 Project Structure

picsee-short-link/
├── SKILL.md              # Agent Skills definition (open standard)
├── cli/                  # CLI Tool (TypeScript)
│   ├── src/
│   │   ├── cli.ts        # CLI entry point + command definitions
│   │   ├── api.ts        # PicSee REST API client
│   │   └── keychain.ts   # AES-256-CBC token storage
│   ├── dist/             # Compiled output
│   ├── package.json
│   └── tsconfig.json
├── references/           # API documentation
├── README.md             # This file
└── _meta.json            # ClawHub registry metadata

📖 Resources

PicSee Website: https://picsee.io
API Documentation: https://picsee.io/developers/docs/public-api.html
Agent Skills Spec: https://agentskills.io

📄 License

MIT

// REPO STATS

0 stars

0 open issues

Last commit: 7mo ago

// SHARE

Share on X Share on LinkedIn