@acedatacloud/skills

AceDataCloud Agent Skills

Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search, and more.

Compatible with 30+ AI coding agents via the agentskills.io open standard: Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, Cursor, Roo Code, Goose, and more.

First run from skills.sh

Choose the service you want, then install that Skill only. Each integration is maintained by Ace Data Cloud and uses your Ace API key; it is not published by the model or service vendor.

For example, install Suno into your Codex project:

npx --yes [email protected] add acedatacloud/skills --skill suno-music -a codex --yes
npx --yes [email protected] list

Replace codex with your supported agent, such as claude-code or cursor. For Codex the files are copied to .agents/skills/suno-music/; start a fresh assistant session. No ClawHub account, OpenClaw installation or paired MCP server is required for this path. Installation itself does not generate media.

Follow the selected service's guide: Ace registration/sign-in → Applications / General application → check service access, balance and current price → copy or create a dedicated API key → make it available to the assistant process → submit once and query the same task ID. The guides include real redacted Ace key-management images and service-specific request examples. A Skill cannot configure an environment variable or load .env automatically; follow your assistant's environment/secret settings. Never paste a key into a prompt.

The optional acedatacloud account Skill can read public catalog/pricing without a key. Account-resource reads such as balance use the separate ACEDATACLOUD_PLATFORM_TOKEN; service generation uses ACEDATACLOUD_API_TOKEN. Neither the account Skill nor a model-provider configuration is a prerequisite for the five service Skills.

First run with ClawHub and OpenClaw

This example uses Suno. The same API-key steps apply to the other AceDataCloud image, video, music, chat, search, and face Skills. A ClawHub account installs Skills; an AceDataCloud API key authorizes API calls. They are separate credentials.

1. Install the Skill

Open Suno on ClawHub and check that the publisher is @acedatacloud. Install the ClawHub CLI if needed, then run:

npm install -g clawhub
clawhub install @acedatacloud/suno
clawhub list

Start a new OpenClaw session so it loads the installed Skill. The ClawHub names are shorter than the folders in this repository: for example, @acedatacloud/suno corresponds to skills/suno-music, and @acedatacloud/nano-banana to skills/nano-banana-image. For other agents, use Quick Install below.

2. Get an AceDataCloud API key

New account? Register and sign in first. If the Applications page has no General application yet, choose Initialize General Application, then continue with the key steps below.

1. Sign in at AceDataCloud → Applications. Create an account first if needed.
2. Open General application (initialize it if the console prompts you). Its key can access the services enabled for your account. A service-specific application key is limited to that service. Enable the intended service if needed, then check its access, balance, and current price before running an example.
3. Copy an existing API key, or choose Manage Keys → Create to make a separate key for OpenClaw. Name it, set an expiration and restrictions if needed, then copy the key from the application card or key list. If you restrict Allowed APIs, include both the generation endpoint and its task-query endpoint. For Suno these are /suno/audios and /suno/tasks.

Copy the key value only. Do not include Bearer or quotation marks when pasting into a credential field. A platform-management token beginning with platform- is for the account-management Skill, not for generation/search requests to api.acedata.cloud.

3. Make the key available to OpenClaw

Put this line in ~/.openclaw/.env on the machine running the OpenClaw Gateway, replacing the placeholder with your key:

ACEDATACLOUD_API_TOKEN=your_api_key_here

OpenClaw loads this global .env file even when its Gateway runs as a service. Restart the Gateway and start a fresh session after changing it. Keep the file private (chmod 600 ~/.openclaw/.env) and never commit it or paste the key into a chat. For a direct terminal-only test, use export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that terminal instead.

4. Submit once, then check the same task

Ask your agent: “Use the Suno Skill to make an instrumental piano melody for a sunrise.” Or run this example after checking the current Suno price; generation is billable:

curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"chirp-v6","prompt":"A gentle instrumental piano melody for a sunrise, no vocals.","instrumental":true,"async":true}'

If the response gives a task ID, copy it and query that same task until it succeeds or fails:

curl -X POST https://api.acedata.cloud/suno/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_TASK_ID"}'

Use the audio URL from the completed result. Do not submit the generation request again just because a task is pending; that creates another billable task. Other Skills have their own request examples and task endpoints in their SKILL.md files.

5. If the first run fails

For more detail, see the authentication guide and task-polling guide. Support: [email protected].

The general ClawHub API guide is the entry point for agents that have not selected a service yet.

Available Skills

AI Music & Audio

AI Image Generation

AI Video Generation

AI Chat & Tools

Connectors

These skills drive third-party connectors users wire up at studio.acedata.cloud/console/connectors. Each declares the OAuth / BYOC connection it needs in connections: frontmatter; the aichat2 runtime injects the matching access token into the sandbox before the skill's Bash calls run.

The content-fanout playbook prepares channel-specific drafts from a canonical source and uses only explicitly selected, connected publishing skills. It requires human review and does not provide unattended bulk posting.

Prerequisites

AceDataCloud API Skills need an API key from Applications. Follow the first-run steps for the exact UI path, key restrictions, OpenClaw environment setup, and a complete example. Local-only Skills such as onepage-pdf and apple-notes do not use an AceDataCloud API key; the acedatacloud account-management Skill uses a separate platform token.

Quick Install

One command to install skills into your project — works with all agents:

# Install all skills (for any agentskills.io-compatible agent)
npx skills add acedatacloud/skills --skill '*' --yes

# Install specific skills only
npx skills add acedatacloud/skills --skill suno-music --skill flux-image --yes

The skills CLI auto-detects your agent and installs to the correct path.

Usage by Platform

Claude Code

Option A: skills CLI (recommended)

# Install all skills for Claude Code
npx skills add acedatacloud/skills --skill '*' -a claude-code --yes

# Install specific skills
npx skills add acedatacloud/skills --skill suno-music -a claude-code --yes

Skills are symlinked into .claude/skills/ and auto-discovered by Claude Code.

Option B: Plugin Marketplace

/plugin marketplace add acedatacloud/skills
/plugin install acedatacloud-ai-media@acedatacloud-skills
/plugin install acedatacloud-ai-tools@acedatacloud-skills

Option C: npm package

npx @acedatacloud/skills install --target .claude/skills

Option D: Manual copy

git clone https://github.com/AceDataCloud/Skills.git
cp -r Skills/skills/* .claude/skills/

GitHub Copilot

npx skills add acedatacloud/skills --skill '*' -a github-copilot --yes

Gemini CLI

npx skills add acedatacloud/skills --skill '*' -a gemini-cli --yes

OpenAI Codex

npx skills add acedatacloud/skills --skill '*' -a codex --yes

WeKnora

Follow the English setup guide or 中文指南 for the current stable version: import a secret-free Suno MCP example, add your Ace key privately, sync tools, build a minimal Agent conversation, and query the same task ID to its final audio URL. The guide maps 17 named services to their reusable Skills.

Cursor

npx skills add acedatacloud/skills --skill '*' -a cursor --yes

Roo Code

npx skills add acedatacloud/skills --skill '*' -a roo --yes

Goose

npx skills add acedatacloud/skills --skill '*' -a goose --yes

Windsurf

npx skills add acedatacloud/skills --skill '*' -a windsurf --yes

Cline

npx skills add acedatacloud/skills --skill '*' -a cline --yes

Other Agents

The skills CLI supports 40+ agents. Use npx skills add --help to see all options, or install to the universal .agents/skills/ path:

npx skills add acedatacloud/skills --skill '*' --yes

Pairing Skills with MCP Servers

Skills provide knowledge (when to use, parameters, gotchas). MCP servers provide tools (executable functions the agent can call). Together they give the best experience.

Using hosted MCP endpoints in Claude Code (no local install needed):

Merge into the project's .mcp.json, preserve existing services, and start Claude Code from a terminal with ACEDATACLOUD_API_TOKEN set. Review the service approval prompt, then run /mcp to verify connection and loaded tools. See shared MCP setup for Amp's configuration and approval checks.

{
  "mcpServers": {
    "suno": {
      "type": "http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"
      }
    }
  }
}

Quick Example

Ask your AI agent:

"Generate a lo-fi hip hop track with rain sounds using Suno"

The agent will:

1. Read the suno-music skill to understand the API
2. Call the Suno MCP server (if configured) or guide you through the API call
3. Handle task polling until the music is ready
4. Return the audio URL

Contributing

We welcome contributions! To add a new skill:

1. Create a directory under skills/ matching the skill name
2. Add a SKILL.md following the Agent Skills specification
3. Use the template as a starting point
4. Reference shared files (../_shared/authentication.md, ../_shared/async-tasks.md, ../_shared/mcp-servers.md) instead of duplicating common sections
5. Submit a pull request — CI will validate your skill format

Note: .agents/skills/ and .github/skills/ are symlinks to skills/ — do not modify files via those paths.

The existing ClawHub-only @acedatacloud/api-guide listing is maintained in clawhub/api-guide/SKILL.md. Its general onboarding instructions are kept separate from the service Skills in skills/.

For a reviewed update to an existing listing, follow the ClawHub maintenance guide. The publishing helper previews one explicit listing by default and pins its source commit.

License

Apache-2.0

Daily capability updates

PlatformBackend ecosystem.py is the only scheduled coordinator. One daily Kubernetes Job reviews Backend docs and API changes with Claude Code, updates existing files, and creates or updates one reviewable PR per repository. It never merges PRs or duplicates the Backend guide tree. Normal CI and review remain required; publication and sub-repository mirroring run after merge.