short-url — Claude Code skill: what it does, how to install
The short-url skill creates short links through the AceDataCloud API. Use it when a long URL needs a compact shareable form.
Apache-2.0 228 installs ★ 17 updated 2026-10-25
npx skills add AceDataCloud/Skills --skill short-url -a claude-codeWhat short-url does
The skill sends a source URL to AceDataCloud and returns a shortened address under the suro.id domain. It uses POST /shorturl, and the API responds immediately rather than requiring task polling.
Set ACEDATACLOUD_API_TOKEN in a .env file before using it. The request’s content value must be a valid URL, so malformed input will stop the shortening request. That requirement is the main setup check.
The README also lists an optional MCP route. Install it with pip install mcp-shorturl, or connect to https://short-url.mcp.acedata.cloud/mcp. The MCP server can be used alongside the skill.
What it helps with
- shorten a long URL through an API
- return a compact link on
suro.id - validate a source address before sending it
- connect URL shortening through MCP
Example prompts for the agent
- Shorten the URL in
README.mdand return the new link. - Send
https://example.com/articleto AceDataCloud and give me its short URL. - Check this address, then submit it to
POST /shorturlusing the configured token.
How to install short-url
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a claude-code2Manually: put the files in place
~/.claude/skills/short-url/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/short-url/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a codex2Manually: put the files in place
.agents/skills/short-url/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a cursor2Manually: put the files in place
.cursor/skills/short-url/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/short-url2Manually: put the files in place
.github/skills/short-url/SKILL.md1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a gemini-cli2Platform CLI
gemini skills install https://github.com/AceDataCloud/Skills --path skills/short-urlManually: put the files in place
.devin/skills/short-url/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill short-url -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about short-url
How do I install short-url in Claude Code?
Run npx skills add AceDataCloud/Skills --skill short-url -a claude-code. The skill file will be placed at ~/.claude/skills/short-url/SKILL.md.
What does short-url do?
It sends a long URL to the AceDataCloud API and returns a shortened link on suro.id. The response is synchronous.
What does short-url require?
Set ACEDATACLOUD_API_TOKEN in .env. The content request value must be a valid URL.
Source text
SKILL.md · Apache-2.0
---
name: short-url
description: Create short URLs via AceDataCloud API. Use when generating shortened links for sharing, or batch-creating multiple short URLs at once. Supports custom slugs and expiration.
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-short-url for tool-use.
---
# Short URL Service
Create short URLs through AceDataCloud's URL shortening API.
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/shorturl \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "https://example.com/very-long-url-path?with=params"}'
```
## Workflows
### 1. Create a Short URL
```json
POST /shorturl
{
"content": "https://example.com/article/2024/awesome-content"
}
```
Response:
```json
{
"data": {
"url": "https://suro.id/abc123"
},
"success": true
}
```
## Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `content` | Yes | The original long URL to shorten |
## Gotchas
- Short URLs use the `suro.id` domain
- Results are returned synchronously — no task polling needed
- The `content` field must be a valid URL to shorten
> **MCP:** `pip install mcp-shorturl` | Hosted: `https://short-url.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)
© acedatacloud · Apache-2.0 · AceDataCloud/Skills