@acedatacloud/skills 2026.621.0 → 2026.621.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.621.0",
+  "version": "2026.621.2",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/discord/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: discord
+description: Read your Discord identity and the list of servers (guilds) you belong to via the Discord API. Use when the user mentions Discord, asks which servers/guilds they are in, or wants their Discord account info.
+when_to_use: |
+  Trigger when the user wants to read their Discord account identity
+  (username, avatar, email) or list the servers (guilds) their connected
+  Discord account belongs to. This connection is read-only identity +
+  guild list; it CANNOT read or send channel messages.
+connections: [discord]
+allowed_tools: [Bash]
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+---
+
+We drive the [Discord API](https://discord.com/developers/docs/reference)
+with `curl + jq`. The user's OAuth bearer token is in `$DISCORD_TOKEN`;
+every call needs it as `Authorization: Bearer $DISCORD_TOKEN`. Use the
+versioned base URL `https://discord.com/api/v10`.
+
+Discord returns standard JSON. Errors look like
+`{"code": <n>, "message": "<reason>"}`. A `401 Unauthorized` means the
+token expired or the connection was revoked — tell the user to re-connect
+Discord at `auth.acedata.cloud/user/connections`. A `429` carries a
+`retry_after` (seconds) field — sleep that long, then retry; never
+parallelize.
+
+**Scope is read-only `identify` + `email` + `guilds`.** This OAuth
+connection can ONLY read the account's identity and the list of guilds it
+belongs to. It CANNOT read/send channel messages, list a guild's channels
+or members, or manage anything — those require a **Discord Bot** (bot
+token + gateway), which this connector does not provide. Do not call
+`/guilds/{id}/channels`, `/channels/...`, or `/guilds/{id}/members` — they
+return 401/403 with a user OAuth token. If the user asks for those, say it
+needs a Discord bot integration, which isn't set up.
+
+## Recipes
+
+### Verify auth + identity (always run first)
+
+```sh
+curl -sS -H "Authorization: Bearer $DISCORD_TOKEN" \
+  "https://discord.com/api/v10/users/@me" \
+  | jq '{id, username, global_name, email, avatar}'
+```
+
+### List the servers (guilds) the user is in
+
+```sh
+curl -sS -H "Authorization: Bearer $DISCORD_TOKEN" \
+  "https://discord.com/api/v10/users/@me/guilds" \
+  | jq 'map({id, name, owner, approximate_member_count})'
+```
+
+Add `?with_counts=true` to include `approximate_member_count` /
+`approximate_presence_count`:
+
+```sh
+curl -sS -H "Authorization: Bearer $DISCORD_TOKEN" \
+  "https://discord.com/api/v10/users/@me/guilds?with_counts=true" \
+  | jq 'map({id, name, owner, members: .approximate_member_count})'
+```
+
+## Notes
+
+- A "server" in the UI is a "guild" in the API. `owner: true` means the
+  user owns that guild.
+- Guild icon URL (when `icon` is non-null):
+  `https://cdn.discordapp.com/icons/<guild_id>/<icon>.png` (use `.gif` if
+  the icon hash starts with `a_`).
+- The guild list paginates at 200; the typical user is in far fewer, so a
+  single call is usually enough. If you ever hit 200, paginate with
+  `?after=<last_guild_id>`.

package/skills/discordbot/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: discordbot
+description: List channels, read recent messages, and send messages on Discord using the user's own bot, via the Discord REST API. Use when the user wants their Discord BOT to post a message, read a channel, or list servers/channels — anything that acts in a server the bot was invited to.
+when_to_use: |
+  Trigger when the user wants to send, read, or list things on Discord
+  through their bot: list the servers/channels the bot can see, read recent
+  messages in a channel, or post / reply in a channel. Messages are sent as
+  the BOT, not the user's personal account, and only in servers the bot has
+  been invited to with the right permissions.
+connections: [discordbot]
+allowed_tools: [Bash]
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+---
+
+We drive the [Discord API](https://discord.com/developers/docs/reference)
+with `curl + jq` using the user's **bot** token in `$DISCORDBOT_TOKEN`. The
+auth header is `Authorization: Bot $DISCORDBOT_TOKEN` — note the literal
+`Bot ` prefix (NOT `Bearer`). Base URL is `https://discord.com/api/v10`.
+
+This acts as the user's registered **bot**, so it can only see and act in
+servers (guilds) the bot has been **invited to** and only where it has the
+relevant permission (View Channels / Send Messages / Read Message History).
+A `403 Forbidden` (code 50001 "Missing Access" / 50013 "Missing
+Permissions") almost always means the bot isn't in that server or lacks the
+permission — tell the user to invite the bot or grant the permission rather
+than retrying.
+
+Errors are JSON `{"code": <n>, "message": "<reason>"}`. A `401` means the
+bot token is wrong/reset — ask the user to re-paste it at
+`auth.acedata.cloud/user/connections`. A `429` carries `retry_after`
+(seconds) — sleep that long, then retry; never parallelize.
+
+**Before sending a message, confirm the exact channel and content with the
+user.** Sending is irreversible and public to that channel.
+
+## Recipes
+
+### Verify the bot (always run first)
+
+```sh
+curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  "https://discord.com/api/v10/users/@me" \
+  | jq '{id, username, bot}'
+```
+
+### List servers (guilds) the bot is in
+
+```sh
+curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  "https://discord.com/api/v10/users/@me/guilds" \
+  | jq 'map({id, name})'
+```
+
+### List text channels in a server
+
+Channel `type` 0 = text, 5 = announcement; 2 = voice, 4 = category (skip
+those for messaging). You need a guild id from the call above.
+
+```sh
+GUILD_ID="123456789012345678"
+curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  "https://discord.com/api/v10/guilds/$GUILD_ID/channels" \
+  | jq 'map(select(.type==0 or .type==5) | {id, name, type})'
+```
+
+### Read recent messages in a channel
+
+Reading message **content** requires the **Message Content Intent** to be
+enabled on the bot (Developer Portal → Bot → Privileged Gateway Intents).
+Without it, `content` comes back empty for messages that don't mention the
+bot. Needs the *Read Message History* permission in that channel.
+
+```sh
+CHANNEL_ID="123456789012345678"
+curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages?limit=20" \
+  | jq 'map({author: .author.username, ts: .timestamp, content})'
+```
+
+### Send a message to a channel
+
+```sh
+CHANNEL_ID="123456789012345678"
+curl -sS -X POST \
+  -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  -H "Content-Type: application/json" \
+  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages" \
+  -d "$(jq -nc --arg c "Hello from the bot." '{content: $c}')"
+```
+
+### Reply to a specific message
+
+```sh
+CHANNEL_ID="123456789012345678"; MESSAGE_ID="987654321098765432"
+curl -sS -X POST \
+  -H "Authorization: Bot $DISCORDBOT_TOKEN" \
+  -H "Content-Type: application/json" \
+  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages" \
+  -d "$(jq -nc --arg c "On it!" --arg m "$MESSAGE_ID" \
+        '{content: $c, message_reference: {message_id: $m}}')"
+```
+
+## Notes
+
+- A "server" in the UI is a "guild" in the API; messages live in channels
+  inside guilds. Always: list guilds → list that guild's channels → act on a
+  channel id. Don't invent ids.
+- The bot only sees servers it was invited to. To add it: Developer Portal →
+  OAuth2 → URL Generator → scope `bot` + the permissions you need → open the
+  URL → pick a server (the user needs *Manage Server* there).
+- This is a bot, not the user's account — it cannot read the user's DMs or
+  the user's full server list, only what the bot itself can access.
+- Mentions: `<@USER_ID>` pings a user, `<#CHANNEL_ID>` links a channel. Plain
+  text is fine for normal messages.