@acedatacloud/skills 2026.406.1 → 2026.406.3

package/README.md

@@ -64,196 +64,111 @@ Get your API token at [platform.acedata.cloud](https://platform.acedata.cloud):
 export ACEDATACLOUD_API_TOKEN="your-token-here"
 ```
 
-## Quick Install (npm)
+## Quick Install
 
-```bash
-# Install globally
-npm install -g @acedatacloud/skills
+**One command** to install skills into your project — works with all agents:
 
-# Copy all skills into your project
-npx @acedatacloud/skills install                          # → .agents/skills/ (universal)
-npx @acedatacloud/skills install --target .claude/skills  # → .claude/skills/ (Claude Code)
-npx @acedatacloud/skills install --target .github/skills  # → .github/skills/ (GitHub Copilot)
+```bash
+# Install all skills (for any agentskills.io-compatible agent)
+npx skills add acedatacloud/skills --skill '*' --yes
 
-# Or use npx directly (no install needed)
-npx @acedatacloud/skills install
+# Install specific skills only
+npx skills add acedatacloud/skills --skill suno-music --skill midjourney-image --yes
 ```
 
+The [`skills` CLI](https://github.com/vercel-labs/skills) auto-detects your agent and installs to the correct path.
+
 ## Usage by Platform
 
 ### Claude Code
 
-**Option A: Copy into your project (recommended)**
+**Option A: `skills` CLI (recommended)**
 
 ```bash
-# Copy skills into your project's .claude/skills/ directory
-mkdir -p .claude/skills
-cp -r Skills/skills/* .claude/skills/
+# 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
 ```
 
-Claude Code auto-discovers skills in `.claude/skills/` when working in that project.
+Skills are symlinked into `.claude/skills/` and auto-discovered by Claude Code.
 
 **Option B: Plugin Marketplace**
 
-```bash
-# Add the marketplace source
-/plugin marketplace add AceDataCloud/Skills
-
-# Install skill bundles
-/plugin install acedatacloud-ai-media@acedatacloud-skills    # 14 media skills
-/plugin install acedatacloud-ai-tools@acedatacloud-skills     # 5 tool skills
 ```
-
-**Option C: Personal skills (available across all projects)**
-
-```bash
-# Copy to your personal skills directory
-mkdir -p ~/.claude/skills
-cp -r Skills/skills/* ~/.claude/skills/
+/plugin marketplace add acedatacloud/skills
+/plugin install acedatacloud-ai-media@acedatacloud-skills
+/plugin install acedatacloud-ai-tools@acedatacloud-skills
 ```
 
-### GitHub Copilot (VS Code)
-
-GitHub Copilot auto-discovers skills from `.github/skills/`, `.claude/skills/`, and `.agents/skills/`:
+**Option C: npm package**
 
 ```bash
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+npx @acedatacloud/skills install --target .claude/skills
 ```
 
-### Gemini CLI
-
-Gemini CLI supports `.agents/skills/` (project) and `~/.agents/skills/` (personal):
+**Option D: Manual copy**
 
 ```bash
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+git clone https://github.com/AceDataCloud/Skills.git
+cp -r Skills/skills/* .claude/skills/
 ```
 
-### OpenAI Codex
-
-Codex supports the agentskills.io standard via `.agents/skills/` and `AGENTS.md`:
+### GitHub Copilot
 
 ```bash
-# Copy skills into your project
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
-
-# AGENTS.md is already included in this repo for Codex discovery
-cp Skills/AGENTS.md .
+npx skills add acedatacloud/skills --skill '*' -a github-copilot --yes
 ```
 
-Codex auto-discovers skills from `.agents/skills/` and reads `AGENTS.md` for context.
-
-### OpenHands / OpenDevin
+### Gemini CLI
 
 ```bash
-# Copy skills into your workspace
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+npx skills add acedatacloud/skills --skill '*' -a gemini-cli --yes
 ```
 
-OpenHands auto-discovers `SKILL.md` files in `.agents/skills/`.
-
-### Roo Code
-
-Roo Code supports `.agents/skills/` (cross-agent) and `.roo/skills/` (Roo-specific):
+### OpenAI Codex
 
 ```bash
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+npx skills add acedatacloud/skills --skill '*' -a codex --yes
 ```
 
-### TRAE (ByteDance)
+### Cursor
 
 ```bash
-# TRAE supports .agents/skills/ directory
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+npx skills add acedatacloud/skills --skill '*' -a cursor --yes
 ```
 
-### Goose (Block)
-
-Goose supports `.agents/skills/` (project) and `~/.agents/skills/` (personal):
+### Roo Code
 
 ```bash
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
+npx skills add acedatacloud/skills --skill '*' -a roo --yes
 ```
 
-### Cursor
-
-Cursor supports the agentskills.io standard. You can also use `.cursor/rules/`:
+### Goose
 
 ```bash
-# Option 1: agentskills.io path
-mkdir -p .agents/skills
-cp -r Skills/skills/* .agents/skills/
-
-# Option 2: Cursor-native path
-mkdir -p .cursor/rules
-cp -r Skills/skills/*/*.md .cursor/rules/
+npx skills add acedatacloud/skills --skill '*' -a goose --yes
 ```
 
 ### Windsurf
 
-Windsurf uses `.windsurf/rules/` for custom instructions:
-
 ```bash
-mkdir -p .windsurf/rules
-cp -r Skills/skills/*/*.md .windsurf/rules/
+npx skills add acedatacloud/skills --skill '*' -a windsurf --yes
 ```
 
 ### Cline
 
-Add skills as custom instructions in Cline:
-
-1. Open Cline sidebar → Settings → Custom Instructions
-2. Paste the content from any `SKILL.md` file
-3. Cline will use the skill context in conversations
-
-Or use `.clinerules` directory:
-
-```bash
-mkdir -p .clinerules
-cp -r Skills/skills/*/*.md .clinerules/
-```
-
-### Continue.dev
-
-Configure in `.continue/rules/`:
-
 ```bash
-mkdir -p .continue/rules
-cp -r Skills/skills/*/*.md .continue/rules/
+npx skills add acedatacloud/skills --skill '*' -a cline --yes
 ```
 
-### Amazon Q Developer
+### Other Agents
 
-Amazon Q uses `.amazonq/rules/`:
+The `skills` CLI supports 40+ agents. Use `npx skills add --help` to see all options, or install to the universal `.agents/skills/` path:
 
 ```bash
-mkdir -p .amazonq/rules
-cp -r Skills/skills/*/*.md .amazonq/rules/
-```
-
-### Zed
-
-Zed reads the `.rules` file at the project root. Copy the skill content you need:
-
-```bash
-cat Skills/skills/suno-music/SKILL.md >> .rules
-```
-
-Zed also reads `AGENTS.md`, `.github/copilot-instructions.md`, and other agent instruction files as compatibility aliases.
-
-### Any agentskills.io-compatible Agent
-
-The universal pattern works with all compatible agents:
-
-```bash
-git clone https://github.com/AceDataCloud/Skills.git
-# Then point your agent to ./Skills/skills/
+npx skills add acedatacloud/skills --skill '*' --yes
 ```
 
 ## Pairing Skills with MCP Servers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.406.1",
+  "version": "2026.406.3",
   "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/_shared/authentication.md

@@ -2,17 +2,29 @@
 
 All AceDataCloud APIs use Bearer token authentication.
 
+## Get Your Token
+
+1. Register at [platform.acedata.cloud](https://platform.acedata.cloud)
+2. Subscribe to a service (most include free quota)
+3. Go to your service's **Credentials** page and create an API token
+
 ## Setup
 
+Create a `.env` file in your project root:
+
 ```bash
-export ACEDATACLOUD_API_TOKEN="your-token-here"
+ACEDATACLOUD_API_TOKEN=your_token_here
 ```
 
-Get your token at [platform.acedata.cloud](https://platform.acedata.cloud):
+Then load it before making API calls:
 
-1. Register an account
-2. Browse and subscribe to a service (most include free quota)
-3. Create an API credential (token)
+```bash
+source .env
+```
+
+> **Agent usage:** If you're running skills through Claude Code or another AI agent, the agent will automatically `source .env` from the project root before calling any API.
+
+> **Important:** Add `.env` to your `.gitignore` — never commit tokens to version control.
 
 ## Usage
 
@@ -23,9 +35,14 @@ curl -X POST https://api.acedata.cloud/<endpoint> \
   -d '{ ... }'
 ```
 
-### Token Types
+## Token Types
+
+| Type | Scope | Use Case |
+|------|-------|----------|
+| **Service Token** | Single service | Default. Created per-subscription |
+| **Global Token** | All services | Create from the platform's global credentials page |
+
+## Gotchas
 
-| Type | Scope |
-|------|-------|
-| **Service Token** | Access to one subscribed service only |
-| **Global Token** | Access to all subscribed services |
+- Tokens are **service-scoped** by default — if you get a 401 on a different service, create a global token or a token for that specific service
+- Tokens do not expire, but can be revoked from the platform

package/skills/ai-chat/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Works as a drop-in replacement for the OpenAI SDK.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Works as a drop-in replacement for the OpenAI SDK.
 ---
 
 # AI Chat — Unified LLM Gateway

package/skills/face-transform/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
 
 # Face Transform

package/skills/fish-audio/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
 
 # Fish Audio — Voice & Audio Synthesis

package/skills/flux-image/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-flux-pro for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-flux-pro for tool-use.
 ---
 
 # Flux Image Generation

package/skills/google-search/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-serp for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-serp for tool-use.
 ---
 
 # Google Search (SERP)

package/skills/hailuo-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
 
 # Hailuo Video Generation

package/skills/kling-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
 
 # Kling Video Generation

package/skills/luma-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-luma for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-luma for tool-use.
 ---
 
 # Luma Video Generation

package/skills/midjourney-image/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-midjourney for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-midjourney for tool-use.
 ---
 
 # Midjourney Image Generation

package/skills/nano-banana-image/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-nano-banana for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-nano-banana for tool-use.
 ---
 
 # NanoBanana Image Generation

package/skills/producer-music/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
 ---
 
 # Producer Music Generation

package/skills/seedance-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedance for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-seedance for tool-use.
 ---
 
 # Seedance Video Generation

package/skills/seedream-image/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedream for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-seedream for tool-use.
 ---
 
 # Seedream Image Generation

package/skills/short-url/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-short-url for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-short-url for tool-use.
 ---
 
 # Short URL Service

package/skills/sora-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-sora for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-sora for tool-use.
 ---
 
 # Sora Video Generation

package/skills/suno-music/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-suno for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-suno for tool-use.
 ---
 
 # Suno Music Generation

package/skills/veo-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-veo for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-veo for tool-use.
 ---
 
 # Veo Video Generation

package/skills/wan-video/SKILL.md

@@ -5,7 +5,7 @@ license: Apache-2.0
 metadata:
   author: acedatacloud
   version: "1.0"
-compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-wan for tool-use.
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-wan for tool-use.
 ---
 
 # Wan Video Generation