AGENTS.md · diff
git:20260713.940be83 to git:20260929.1d31007
16 added, 49 removed. Audit A to A.
# AceDataCloud Agent Skills
- This repository contains Agent Skills for [AceDataCloud](https://platform.acedata.cloud) AI services.
-
- ## Available Skills
-
- Skills are located in the `skills/` directory (also mirrored to `.agents/skills/` and `.github/skills/`).
-
- ### AI Music & Audio
- - **suno-music** — Generate AI music, lyrics, covers, and vocal extraction with Suno
- - **producer-music** — Generate music, covers, extend tracks, swap vocals with Producer
- - **fish-audio** — Text-to-speech and voice synthesis with Fish Audio
-
- ### AI Image Generation
- - **flux-image** — Generate and edit images with Flux (Black Forest Labs)
- - **seedream-image** — Generate and edit images with ByteDance Seedream
- - **nano-banana-image** — Generate and edit images with Google Gemini (NanoBanana)
-
- ### AI Video Generation
- - **luma-video** — Generate videos with Luma Dream Machine
- - **sora-video** — Generate videos with OpenAI Sora
- - **veo-video** — Generate videos with Google Veo (native audio)
- - **kling-video** — Generate videos with Kuaishou Kling (motion control)
- - **hailuo-video** — Generate videos with Hailuo / MiniMax
- - **happyhorse-video** — Generate and edit videos with Happy Horse
- - **seedance-video** — Generate dance/motion videos with ByteDance Seedance
- - **wan-video** — Generate videos with Alibaba Wan
- - **maestro-video** — Produce complete videos from a brief with scripting, media, voiceover, editing, captions, and multilingual variants
-
- ### AI Chat & Tools
- - **ai-chat** — Unified LLM gateway — GPT, Claude, Gemini, Kimi, Grok (50+ models)
- - **google-search** — Search the web, images, news, maps, places, and videos via Google
- - **tgstat** — Discover and analyze public Telegram channels/groups (BYOC username; no login)
- - **face-transform** — Face analysis, beautification, age/gender transform, swap, cartoon
- - **short-url** — Create and manage short URLs
- - **onepage-pdf** — Convert an HTML page into one tall single-page PDF (local; no API token; needs Python + pymupdf + Chrome/Edge)
- - **apple-notes** — Manage Apple Notes on macOS: create, search, read, export, organize notes (macOS-only; local; no API token; drives Notes.app via AppleScript)
- - **acedatacloud** — Manage your AceDataCloud account — balance, usage/spend, API keys, services, orders, announcements
-
- ## Authentication
-
- All skills require an API token:
-
- ```bash
- export ACEDATACLOUD_API_TOKEN="your-token-here"
- ```
-
- Get your token at [platform.acedata.cloud](https://platform.acedata.cloud).
-
- ## Paired MCP Servers
+ The canonical skill files are `skills/<name>/SKILL.md`. Use `README.md`
+ or the `skills/` directory to find the current catalog; do not maintain a
+ second skill list here. `.agents/skills/` and `.github/skills/` are
+ symlinks to `skills/`, so edit the canonical path.
- Each skill has a corresponding MCP server for tool-use capabilities. See the main [README](README.md) for the full mapping.
+ - Keep each skill's description short and specific to when that skill
+ should load. Put task procedures and examples in its body or relevant
+ supporting files.
+ - Reuse `skills/_shared/` references for common AceDataCloud API
+ authentication, async tasks, and MCP guidance.
+ - Skills that call AceDataCloud APIs need an AceDataCloud Bearer token.
+ Local skills such as `onepage-pdf` and `apple-notes` do not. Follow
+ the selected skill's authentication instructions; never commit or
+ print tokens.
+ - When adding or changing a skill, update its own instructions and any
+ catalog entry that describes it, then run the applicable checks from
+ `.github/workflows/validate.yml`.