# Send uf2.net URL Shortener 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": "uf2-net",
    "name": "uf2.net URL Shortener",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/setdemos/uf2-net",
    "canonicalUrl": "https://clawhub.ai/setdemos/uf2-net",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/uf2-net",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uf2-net",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api.md",
      "scripts/uf2.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "uf2-net",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T20:29:28.014Z",
      "expiresAt": "2026-05-19T20:29:28.014Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uf2-net",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uf2-net",
        "contentDisposition": "attachment; filename=\"uf2-net-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "uf2-net"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/uf2-net"
    },
    "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/uf2-net",
    "downloadUrl": "https://openagent3.xyz/downloads/uf2-net",
    "agentUrl": "https://openagent3.xyz/skills/uf2-net/agent",
    "manifestUrl": "https://openagent3.xyz/skills/uf2-net/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/uf2-net/agent.md"
  }
}
```
## Documentation

### uf2.net URL Shortener

Create and manage short URLs via the uf2.net API. This skill provides a CLI wrapper for the uf2.net service (https://uf2.net), an API-first URL shortener designed for automation and bots.

### 1. Register for API Key

If you don't have a uf2.net account:

curl -X POST https://uf2.net/api/v1/accounts/register \\
  -H "Content-Type: application/json" \\
  -d '{"username":"your-username"}'

Response includes api_key field. Store this securely (see Credential Management below).

### 2. Set Environment Variable

export UF2_API_KEY="uf2_..."

Important: Do not hardcode API keys in scripts or commit them to version control.

### 3. Common Operations

Shorten a URL:

scripts/uf2.sh create "https://example.com/long/path"
# → {"short_url":"https://uf2.net/abc123",...}

Custom slug:

scripts/uf2.sh create "https://github.com/my-repo" "my-repo" "My GitHub Repo"
# → {"short_url":"https://uf2.net/my-repo",...}

List your links:

scripts/uf2.sh list 10
# → {"links":[...],"total":42}

Get link stats (public, no auth needed):

scripts/uf2.sh get abc123
# → {"code":"abc123","click_count":42,...}

Delete a link:

scripts/uf2.sh delete abc123

### Recommended: Environment Variables

Most secure for temporary/session use:

export UF2_API_KEY="uf2_..."

### For Persistent Storage

Choose one based on your security requirements:

Option 1: Shell profile (user-only access)

echo 'export UF2_API_KEY="uf2_..."' >> ~/.zshrc
# or ~/.bashrc for bash

Option 2: OpenClaw secret store (if available)

# Store in OpenClaw's secure credential storage
# (consult OpenClaw docs for secret management)

Option 3: System keychain/credential manager

# macOS Keychain, Linux Secret Service, Windows Credential Manager
# Use OS-native secure storage

⚠️ Avoid: Storing keys in plain text files in shared or version-controlled directories.

### Direct API Usage

For operations not covered by the script, use curl directly. See api.md for full API reference.

Example:

curl -X POST https://uf2.net/api/v1/links \\
  -H "X-API-Key: $UF2_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"url":"https://example.com","slug":"custom"}'

### Service Details

Service: uf2.net (https://uf2.net)
Type: API-first URL shortener for bots and engineers
TLS: Yes (HTTPS only)
API Docs: https://uf2.net/docs (Swagger), https://uf2.net/redoc (ReDoc)
Registration: Open, free tier available
Rate Limits: 20 registrations per IP per hour; reasonable use for authenticated endpoints

### Key Features

Never expires - Links remain active indefinitely
Custom slugs - Brand your short URLs (4-64 chars, lowercase a-z0-9_-)
Click tracking - Monitor usage via click_count
Public metadata - Anyone can view link stats (GET /links/{code})
Simple API - RESTful with JSON responses

### Constraints

Max URL length: 2048 characters
Custom slugs are case-insensitive (stored lowercase)
Slug conflicts return 409 error
Private/localhost URLs rejected
Registration rate limit: 20 per IP per hour

### Security Notes

API key required: All authenticated operations require UF2_API_KEY header
Link visibility: All created links are publicly accessible (anyone with the short URL can access the target)
Metadata visibility: Link metadata (click counts, original URL) is publicly readable
No link expiration: Links persist indefinitely unless manually deleted
Private URL rejection: The service rejects localhost and private IP ranges

### Resources

Script: scripts/uf2.sh - CLI wrapper for common operations
Reference: references/api.md - Full API documentation
Service homepage: https://uf2.net
API docs: https://uf2.net/docs (Swagger), https://uf2.net/redoc (ReDoc)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: setdemos
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T20:29:28.014Z
- Expires at: 2026-05-19T20:29:28.014Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/uf2-net)
- [Send to Agent page](https://openagent3.xyz/skills/uf2-net/agent)
- [JSON manifest](https://openagent3.xyz/skills/uf2-net/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/uf2-net/agent.md)
- [Download page](https://openagent3.xyz/downloads/uf2-net)